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

Retrieves the media type to be used by the output pin.

Syntax

HRESULT GetMediaType(
  int 
iPosition,
  CMediaType* 
pMediaType 
);

Parameters

iPosition

Position of the media type in the media type list.

pMediaType

Returned media type object.

Return Value

Returns E_UNEXPECTED because it is not expected to be called.

Remarks

In the CTransformFilterclass, this member function is called by the associated input or output pin class's GetMediaTypemember function to retrieve the next media type in the list and return it to the pin's CBasePin::EnumMediaTypesmember function.

However, in the CTransInPlaceFilterclass, the pin classes override the CBasePin::EnumMediaTypesmember function so that it bypasses the filter and calls the enumerator of the opposite connected pin.

(For example, the output pin enumerator uses the upstream filter's enumerator, and the input pin uses the connected downstream filter's enumerator.)

Therefore, this member function should never be called by the inplace pin classes. It is implemented to prevent undefined, pure virtual compiler warnings.

Requirements

Windows Embedded CE Windows CE 2.12 and later
Note Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements
For more information, see Setting Up the Build Environment,
Version 2.12 requires DXPAK 1.0 or later