IMFMediaSink::AddStreamSink 方法 (mfidl.h)

將新的資料流程接收新增至媒體接收。

語法

HRESULT AddStreamSink(
  [in]  DWORD         dwStreamSinkIdentifier,
  [in]  IMFMediaType  *pMediaType,
  [out] IMFStreamSink **ppStreamSink
);

參數

[in] dwStreamSinkIdentifier

新資料流程的識別碼。 此值為任意值,但必須是唯一的。

[in] pMediaType

IMFMediaType介面的指標,指定資料流程的媒體類型。 此參數可以是 Null

[out] ppStreamSink

接收新資料流程接收之 IMFStreamSink 介面的指標。 呼叫端必須釋放 介面。

傳回值

方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。

傳回碼 描述
S_OK
此方法已成功。
MF_E_INVALIDSTREAMNUMBER
指定的資料流程識別碼無效。
MF_E_SHUTDOWN
已呼叫媒體接收的 Shutdown 方法。
MF_E_STREAMSINK_EXISTS
已經有具有相同資料流程識別碼的資料流程接收。
MF_E_STREAMSINKS_FIXED
此媒體接收有一組固定的資料流程接收。 無法新增資料流程接收。

備註

並非所有媒體接收都支援此方法。 如果媒體接收不支援此方法, IMFMediaSink::GetCharacteristics 方法會傳回MEDIASINK_FIXED_STREAMS旗標。

如果 pMediaTypeNull,請使用 IMFMediaTypeHandler 介面來設定媒體類型。 呼叫 IMFStreamSink::GetMediaTypeHandler 以取得介面的指標。

需求

   
最低支援的用戶端 Windows Vista [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 mfidl.h
程式庫 Mfuuid.lib

另請參閱

IMFMediaSink

媒體接收