Developer

API Reference

ITRANSITION_QueryInterface()

deprecated
Items marked as deprecated have been replaced by a more powerful, alternative feature. Deprecated interfaces include a reference to the replacement interface, which should be used for all new application development. Deprecated features are still supported for backward compatibility, but should be avoided when developing new applications.
Brew Release
Brew MP 1.0.2
See Also
Error Codes IQI_QueryInterface ITransition
Description
This function queries an interface for an alterrnate 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 'd' parameter. The requested interface is identified by a globally unique ID passed to the function in the 'c' parameter.
Parameters
  • p
    []:
    Pointer to the ITransition interface object.
  • c
    []:
    A globally unique id that identifies the interface to be queried.
  • d
    []:
    Pointer to a pointer returned by the function to reference the interface requested by the "c" parameter. If the queried item is not available, this pointer is returned as NULL.
Interface
ITRANSITION
Prototype
   int ITRANSITION_QueryInterface(ITransition *p, AEECLSID c, void **d);
Return
AEE_SUCCESS : the requested interface was found and has been returned in the "d" parameter. AEE_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.
Comment
The pointer passed in the "d" parameter is a double-indirection (i.e., a pointer to a pointer). Applets should use care in ensuring that the proper level of indirection is used in calling the function.
  • Follow