Microsoft DirectX 9.0


The GetMediaType method retrieves the media type, if the media type differs from the previous sample.


HRESULT GetMediaType(
  AM_MEDIA_TYPE **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 an HRESULT value. Possible values include those 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.


This method enables a filter to make limited changes to the media type, such as changing the palette. To make a significant change to the media type, the pins might need to reconnect and renegotiate the media type.

If the method returns S_OK, the caller must free the memory for the media type, including the format block. You can use the DeleteMediaType function in the DirectShow base class library.

See Also