Share via


IMediaSample::GetMediaType

 
Microsoft DirectShow 9.0

IMediaSample::GetMediaType

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 Values

Returns an HRESULT value. Possible values include those shown in the following table.

Return code 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.

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.

Requirements

Header: Declared in Strmif.h; include Dshow.h.

Library: Use Strmiids.lib.

See Also