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

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 HRESULTvalue by the overriding member function.

It returns VFW_S_NO_MORE_ITEMSwhen 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::Nextmethod 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::GetMediaTypemember 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