Share via

CTransformOutputPin::GetMediaType

  • Article
 
Microsoft DirectShow 9.0

CTransformOutputPin::GetMediaType

The GetMediaType method retrieves a preferred media type, by index value.

Syntax

  HRESULT GetMediaType(
    int iPosition,
    CMediaType *pMediaType
);

Parameters

iPosition

Zero-based index value.

pMediaType

Pointer to a CMediaType object that receives the media type.

Return Value

Returns an HRESULT value. Possible values include those shown in the following table.

Value Description
S_OK Success
VFW_S_NO_MORE_ITEMS Index out of range

Remarks

This method overrides the CBasePin::GetMediaType method. If the filter's input pin is not connected, the method returns VFW_S_NO_MORE_ITEMS. Otherwise, it calls the filter's CTransformFilter::GetMediaType method to retrieve the media type. The CTransformFilter::GetMediaType method is pure virtual; the filter's derived class must override it.

Requirements

**  Header:** Declared in Transfrm.h; include Streams.h.

**  Library:** Use Strmbase.lib (retail builds) or Strmbasd.lib (debug builds).

See Also

CTransformOutputPin Class