API Reference


Brew Release
Brew MP 1.0.2
See Also
- IQI_QueryInterface()
This function queries an interface for an alternate interface that may provide extended functionality or a proprietary extension. If successful, the function will return a pointer to the requested interface in the memory location pointed to by the 'ppif' parameter. The requested interface is identified by a globally unique ID passed to the function in the 'id' parameter.
   int IObserver_QueryInterface(IObserver *pif, AEECLSID id, void **ppif)
AEE_SUCCESS - The requested interface was found and has been returned in the 'ppif' parameter ECLASSNOTSUPPORT - The requested interface is not supported
Side Effect
Upon successful retrieval of an interface pointer, that interface is returned with its reference count incremented. The caller is responsible for releasing this object at some point in the future.
The pointer passed in the 'ppif' parameter is a double-indirection -- i.e., it is a pointer to a pointer. Applications should use care in ensuring that the proper level of indirection is used in calling the function.
  • Follow