Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function enumerates registered DMOs. The caller can search by category, media type, or both.

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

One of the DMO GUIDs. It specifies which category of DMO to search. Use GUID_NULL to search every category.

dwFlags

Bitwise combination of zero or more flags from the DMO_ENUM_FLAGSenumeration.

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_MEDIATYPEstructures that contain the input media types. Specify the size of the array in the cInTypesparameter.

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_MEDIATYPEstructures that contain the output media types. Specify the size of the array in the cOutTypesparameter.

ppEnum

Address of a variable to receive the IEnumDMOinterface of the enumerator.

Return Value

Returns an HRESULTvalue. Possible values include the following.

Value Description

S_OK

Success

E_FAIL

Failure

E_OUTOFMEMORY

Insufficient memory

Remarks

This method returns a pointer to an enumerator object that supports the IEnumDMOinterface. The application uses the IEnumDMOinterface to enumerate over the set of DMOs that match the search criteria.

Requirements

Header dmo.h
Library msdmo.lib
Windows Embedded CE Windows CE .NET 4.1 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also