IMediaSample::GetMediaType

This method retrieves the media type of the IMediaSample object.

HRESULT GetMediaType(
  AM_MEDIA_TYPE** ppMediaType
);

Parameters

  • ppMediaType
    [in] Pointer to a pointer to the retrieved media type.

Return Values

Returns an HRESULT value. When a sample is received and there is no format change, this method returns S_FALSE.

Remarks

This method allows for limited in-band format changes. Free the format block with FreeMediaType, and then free the entire media type with the Win32 CoTaskMemFree function.

Requirements

DirectShow applications and DirectShow filters have different include file and link library requirements. See Setting Up the Build Environment for more information.

OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.

See Also

IMediaSample Interface

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.