Microsoft DirectX 8.1 (C++) |
The DMOEnum function enumerates registered DMOs. The caller can search by category, media type, or both.
Requirements
Declared in Dmoreg.h; include Dmo.h. Link to Msdmo.lib.
Syntax
HRESULT DMOEnum(
REFGUID guidCategory,
DWORD dwFlags,
DWORD cInTypes,
const DMO_PARTIAL_MEDIATYPE *pInTypes,
DWORD cOutTypes,
const DMO_PARTIAL_MEDIATYPE *pOutTypes,
IEnumDMO **ppEnum
);
Parameters
guidCategory
GUID that specifies which category of DMO to search. Use GUID_NULL to search every category. See DMO GUIDs for a list of category GUIDs.
dwFlags
Bitwise combination of zero or more flags from the DMO_ENUM_FLAGS enumeration.
cInTypes
Number of input media types to use in the search criteria. Use zero to match any input type.
pInTypes
Pointer to an array of DMO_PARTIAL_MEDIATYPE structures that contain the input media types. Specify the size of the array in the cInTypes parameter.
cOutTypes
Number of output media types to use in the search criteria. Use zero to match any output type.
pOutTypes
Pointer to an array of DMO_PARTIAL_MEDIATYPE structures that contain the output media types. Specify the size of the array in the cOutTypes parameter.
ppEnum
Address of a variable to receive the IEnumDMO interface of the enumerator.
Return Value
Returns an HRESULT value. Possible values include the following.
Result Code | Description |
E_FAIL | Failure |
E_OUTOFMEMORY | Insufficient memory |
S_OK | Success |
Remarks
This method returns a pointer to an enumerator object that supports the IEnumDMO interface. The application uses the IEnumDMO interface to enumerate over the set of DMOs that match the search criteria.
See Also