MFCreateSinkWriterFromMediaSink function (mfreadwrite.h)

Article
02/22/2024

Creates the sink writer from a media sink.

Syntax

HRESULT MFCreateSinkWriterFromMediaSink(
  [in]  IMFMediaSink  *pMediaSink,
  [in]  IMFAttributes *pAttributes,
  [out] IMFSinkWriter **ppSinkWriter
);

Parameters

[in] pMediaSink

Pointer to the IMFMediaSink interface of a media sink.

[in] pAttributes

Pointer to the IMFAttributes interface. You can use this parameter to configure the sink writer. For more information, see Sink Writer Attributes. This parameter can be NULL.

[out] ppSinkWriter

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

Return value

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

Remarks

Call CoInitialize(Ex) and MFStartup before calling this function.

When you are done using the media sink, call the media sink's IMFMediaSink::Shutdown method. (The sink writer does not shut down the media sink.) Release the sink writer before calling Shutdown on the media sink.

This function is available on Windows Vista if Platform Update Supplement for Windows Vista is installed.

Requirements

Requirement	Value
Minimum supported client	Windows 7, Windows Vista and Platform Update Supplement for Windows Vista [desktop apps \| UWP apps]
Minimum supported server	Windows Server 2008 R2 [desktop apps \| UWP apps]
Target Platform	Windows
Header	mfreadwrite.h
Library	Mfreadwrite.lib
DLL	Mfreadwrite.dll