Microsoft DirectX 8.1 (C++)

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.

See Also