MFCreateMuxSink function (mfidl.h)

Article
02/22/2024

Creates a generic media sink that wraps a multiplexer Microsoft Media Foundation transform (MFT).

Syntax

HRESULT MFCreateMuxSink(
  [in]  GUID          guidOutputSubType,
  [in]  IMFAttributes *pOutputAttributes,
  [in]  IMFByteStream *pOutputByteStream,
  [out] IMFMediaSink  **ppMuxSink
);

Parameters

[in] guidOutputSubType

The subtype GUID of the output type for the MFT.

[in] pOutputAttributes

A list of format attributes for the MFT output type. This parameter is optional and can be NULL.

[in] pOutputByteStream

A pointer to the IMFByteStream interface of a byte stream. The output from the MFT is written to this byte stream. This parameter can be NULL.

[out] ppMuxSink

Receives a pointer to the IMFMediaSink interface of the media sink. The caller must release the interface.

Return value

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

This function attempts to find a multiplexer MFT that supports an output type with the following definition:

Major type: MFMediaType_Stream
Subtype: guidOutputSubType
Additional format attributes (optional)

To provide a list of additional format attributes:

Call MFCreateAttributes to get an IMFAttributes pointer.
Use the IMFAttributes interface to set the attributes. (See Media Type Attributes.)
Pass the IMFAttributes pointer in the pOutputAttributes parameter.

The multiplexer MFT must be registered in the MFT_CATEGORY_MULTIPLEXER category.

Requirements

Requirement	Value
Minimum supported client	Windows 8 [desktop apps only]
Minimum supported server	None supported
Target Platform	Windows
Header	mfidl.h
Library	Mf.lib
DLL	Mf.dll