Share via

CMediaSample::GetMediaType

  • Article
 
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