Partager via


CTransformOutputPin::GetMediaType

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

Returns the media type for the output pin to use.

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 an HRESULT value that depends on the implementation of the pure virtual CTransformFilter::GetMediaType member function.

HRESULT can include one of the following constants.

Value Description

NOERROR

A media type is returned.

S_FALSE

Although the iPosition parameter typically is valid, it does not correspond to a media type that is currently valid.

VFW_S_NO_MORE_ITEMS

The iPosition parameter is beyond the valid range.

Use other standard error values, such as E_INVALIDARG, for error cases.

Remarks

This member function overrides the CBasePin::GetMediaType member function and calls the pure virtual CTransformFilter::GetMediaType member function, which must be overridden to return media types supported by your filter.

This is part of the implementation of CBasePin::EnumMediaTypes.

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