CBasePin::GetMediaType
Microsoft DirectShow 9.0 |
CBasePin::GetMediaType
The GetMediaType method retrieves a preferred media type, by index value.
Syntax
virtual 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 in the following table.
Value | Description |
S_OK | Success. |
VFW_S_NO_MORE_ITEMS | Index out of range. |
E_INVALIDARG | Index less than zero. |
E_UNEXPECTED | Unexpected error. |
Remarks
From the pin's list of preferred media types, this method returns the type with an index value of iPosition. The CEnumMediaTypes class calls this method to enumerate preferred media types.
The base class returns E_UNEXPECTED. Override this method in your derived class.
Requirements
** Header:** Declared in Amfilter.h; include Streams.h.
** Library:** Use Strmbase.lib (retail builds) or Strmbasd.lib (debug builds).
See Also