API Reference | developer.brewmp.com API Reference | developer.brewmp.com

Developer

API Reference

IMODULE_CREATEINSTANCE()

Brew Release
Brew MP 1.0.2
See Also
Error Codes IModule
Description
This function provides the mechanism for the AEE to request classes on an as-needed basis from the module. After successfully creating the requested object class, the module returns the class object with a positive reference count.
NOTE: The requested class must be implemented according to the class definition specified for the class.
Params
pIModule
[]:
[in] pointer to theIModule Interface object.
pIShell
[]:
[in] pointer to the IShell Interface object.
ClsId
[]:
[in] requested ClassID exposed by the module.
ppObj
[]:
[out] returned object. Filled by the IMODULE_CreateInstance() function.
Interface
  • IMODULE
Prototype
  •   int IMODULE_CreateInstance
      (
        IModule * pIModule,
        IShell * pIShell,
        AEECLSID ClsId,
        void * * ppObj
      );
    
Return
  • AEE_SUCCESS : The object class was created. AEE_ENOMEMORY : Insufficient memory. AEE_EBADCLASS : The requested class is unsupported.
Side Effect
  • None
Comments
The object must be returned with a positive reference count. Refer to the AEECLSID_xxx topics for a complete list of AEECLSIDs.