dmPMGetProperty(3dm)

NAME
     dmPMGetProperty - retrieves a property of the specified plugin


SYNOPSIS
     #include <dmedia/fx_plugin_mgr.h>

     DMboolean dmPMGetProperty
           ( DMplugin* plugin,
             int property,
             void ** value )

PARAMETERS
     plugin     A pointer to a DMplugin, which was created with dmPMInitPlugin
                or dmPMInitDirectory.

     property   A property to obtain from the plugin.

     value      dmPMGetProperty will fill in the value of the property.



DESCRIPTION
     dmPMGetProperty allows the application to request information from a
     plugin.  This information is in the form of properties.  The properties
     consist of:


     DM_PLUGIN_INTRODUCES_ALPHA     Boolean: if alpha will be introduced upon
                                    executing this plugin

     DM_PLUGIN_IMAGE_FORMATS        unsigned int: the buffer format

     DM_PLUGIN_VERSION              major.minor: the version of the plugin

     DM_PLUGIN_IS_VARIABLE          Boolean: if the plugin varies over time

     DM_PLUGIN_DESCRIPTION          char *: a long description of the plugin

     DM_PLUGIN_DEBUGGING            Boolean: if the plugin is in debug mode



CAVEATS
     Calling dmPMGetProperty, will cause the plugin to be loaded with
     dlopen(3) if it is not already loaded.


RETURN VALUES
     dmPMGetProperty will return DM_SUCCESS if successful, or will return
     DM_FAILURE if it fails.
SEE ALSO
     dmPMCreateManager(3dm), dmPMInitPlugin(3dm), dmGetError(3dm).