Share via


CTransformFilter::GetMediaType

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

Returns one of the media types that the output pin supports (pure virtual).

Syntax

virtual HRESULT GetMediaType(
  int iPosition,
  CMediaType* pMediaType
) PURE;

Parameters

  • iPosition
    Position of the media type in the media type list.
  • pMediaType
    Returned media type object.

Return Value

Returns an HRESULT value by the overriding member function.

It returns VFW_S_NO_MORE_ITEMS when asked for a media type beyond the position list.

It might return S_FALSE to indicate that the media type exists but is not usable. In this case, the IEnumMediaTypes::Next method skips this media type.

Remarks

The derived class is responsible for implementing this member function and maintaining the list of media types that it supports.

The base transform class assumes that only the output pin proposes media types, because the output pin depends on the type of connection of the input pin. For this reason, it is only the CTransformOutputPin::GetMediaType member function of the output pin that is routed to this function.

Requirements

Windows Embedded CE Windows CE 2.12 and later
Windows Mobile Windows Mobile Version 5.0 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