CMediaSample::GetMediaType
Microsoft DirectShow 9.0 |
CMediaSample::GetMediaType
The GetMediaType method retrieves the media type, if the media type differs from the previous sample. This method implements the IMediaSample::GetMediaType method.
Syntax
HRESULT GetMediaType( AM_MEDIA_TYPE **ppMediaType );
Parameters
ppMediaType
Address of a variable that receives a pointer to an AM_MEDIA_TYPE structure. If the media type has not changed from the previous sample, *ppMediaType is set to NULL.
Return Value
Returns one of the HRESULT values shown in the following table.
Value | Description |
S_FALSE | The media type has not changed from the previous sample. |
S_OK | Success. |
E_OUTOFMEMORY | Insufficient memory. |
Remarks
When you are done with the media type, free the memory block by calling the DeleteMediaType utility function.
The CMediaSample::m_pMediaType member variable specifies the media type. The CMediaSample::m_dwFlags member variable specifies whether the media type has changed.
Requirements
** Header:** Declared in Amfilter.h; include Streams.h.
** Library:** Use Strmbase.lib (retail builds) or Strmbasd.lib (debug builds).
See Also