IMFStreamSink::GetMediaTypeHandler method (mfidl.h)

Article
02/22/2024

Retrieves the media type handler for the stream sink. You can use the media type handler to find which formats the stream supports, and to set the media type on the stream.

Syntax

HRESULT GetMediaTypeHandler(
  [out] IMFMediaTypeHandler **ppHandler
);

Parameters

[out] ppHandler

Receives a pointer to the IMFMediaTypeHandler interface. The caller must release the interface.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code	Description
S_OK	The method succeeded.
MF_E_SHUTDOWN	The media sink's Shutdown method has been called.
MF_E_STREAMSINK_REMOVED	This stream was removed from the media sink and is no longer valid.

Remarks

If the stream sink currently does not support any media types, this method returns a media type handler that fails any calls to IMFMediaTypeHandler::GetCurrentMediaType and IMFMediaTypeHandler::IsMediaTypeSupported.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps \| UWP apps]
Minimum supported server	Windows Server 2008 [desktop apps \| UWP apps]
Target Platform	Windows
Header	mfidl.h
Library	Mfuuid.lib