dmPMGetProperty(3dm)					  dmPMGetProperty(3dm)

NAME    [Toc]    [Back]

     dmPMGetProperty - retrieves a property of the specified plugin

SYNOPSIS    [Toc]    [Back]

     #include <dmedia/fx_plugin_mgr.h>

     DMboolean dmPMGetProperty    [Toc]    [Back]
	   ( DMplugin* plugin,
	     int property,
	     void ** value )

PARAMETERS    [Toc]    [Back]

     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    [Toc]    [Back]

     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    [Toc]    [Back]

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

RETURN VALUES    [Toc]    [Back]

     dmPMGetProperty will return DM_SUCCESS if successful, or will return
     DM_FAILURE	if it fails.




									Page 1






dmPMGetProperty(3dm)					  dmPMGetProperty(3dm)

SEE ALSO    [Toc]    [Back]

     dmPMCreateManager(3dm), dmPMInitPlugin(3dm), dmGetError(3dm).


									PPPPaaaaggggeeee 2222