IMFStreamSink::GetMediaTypeHandler Method

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

public:
HRESULT GetMediaTypeHandler(
         IMFMediaTypeHandler **ppHandler
)

Parameters

ppHandler
Type: IMFMediaTypeHandler **

[out, optional]

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

Return value

Type: HRESULT

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

Return codes

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.

Refer to Media Foundation return codes.

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

Header: Declared in mfidl.h.

Library: Use mfuuid.lib.