Share via


CTransInPlaceFilter::GetMediaType

A version of this page is also available for

Windows Embedded CE 6.0 R3

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 CTransformFilter class, this member function is called by the associated input or output pin class's GetMediaType member function to retrieve the next media type in the list and return it to the pin's CBasePin::EnumMediaTypes member function.

However, in the CTransInPlaceFilter class, the pin classes override the CBasePin::EnumMediaTypes member 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