| Microsoft DirectX 8.1 (C++) |
The GetMediaType method retrieves the media type, if the media type differs from the previous sample.
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 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. |
Remarks
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.
When you are done with the media type, free the memory block by calling the DeleteMediaType utility function.
See Also