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 retrieves the media types registered for a DMO.

Syntax

HRESULT DMOGetTypes(
  REFCLSID 
clsidDMO,
  unsigned long 
ulInputTypesRequested,
  unsigned long* 
pulInputTypesSupplied,
  DMO_PARTIAL_MEDIATYPE* 
pInputTypes,
  unsigned long 
ulOutputTypesRequested,
  unsigned long* 
pulOutputTypesSupplied,
  DMO_PARTIAL_MEDIATYPE* 
pOutputTypes
);

Parameters

clsidDMO

Class identifier (CLSID) of the DMO.

ulInputTypesRequested

Size of the array passed in the pInputTypesparameter.

pulInputTypesSupplied

Pointer to a variable that receives the number of DMO_PARTIAL_MEDIATYPEstructures in pInputTypesthat the function fills.

pInputTypes

Pointer to a caller-allocated array of DMO_PARTIAL_MEDIATYPEstructures. The size of the array is given in the ulInputTypesRequestedparameter. The function fills the array with the input types registered for the DMO.

ulOutputTypesRequested

Size of the array passed in the pOutputTypesparameter.

pulOutputTypesSupplied

Pointer to a variable that receives the number of DMO_PARTIAL_MEDIATYPEstructures in pOutputTypesthat the function fills.

pOutputTypes

Pointer to a caller-allocated array of DMO_PARTIAL_MEDIATYPEstructures. The size of the array is given in the ulOutputTypesRequestedparameter. The function fills the array with the DMO output types registered for the DMO.

Return Value

Returns an HRESULTvalue. Possible values include the following.

Value Description

S_FALSE

Array too small

S_OK

Success

E_FAIL

Failure

Remarks

If one of the arrays is too small to hold all of the registered types, the function fills the array but returns S_FALSE.

If the DMO did not register any media types, the function returns S_OK and sets *pulInputTypesSuppliedand *pulOutputTypesSuppliedto zero.

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