Share via

CTransformOutputPin::GetMediaType

  • Article

Returns the media type for the output pin to use.

HRESULT GetMediaType(
  int iPosition,
  CMediaType* pMediaType 
);

Parameters

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

Return Values

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

DirectShow applications and DirectShow filters have different include file and link library requirements. See Setting Up the Build Environment for more information.

OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.
Header:

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.