共用方式為

IMFCaptureSink：：AddStream 方法 (mfcaptureengine.h)

  • 發行項

將數據流從擷取來源連線到這個擷取接收。

語法

HRESULT AddStream(
  [in]  DWORD         dwSourceStreamIndex,
  [in]  IMFMediaType  *pMediaType,
  [in]  IMFAttributes *pAttributes,
  [out] DWORD         *pdwSinkStreamIndex
);

參數

[in] dwSourceStreamIndex

要連線的來源數據流。 此值可以是下列任一項。

值 意義
0–0xFFFFFFFB
 數據流以零起始的索引。 若要取得數據流數目，請呼叫 IMFCaptureSource：：GetDeviceStreamCount。
MF_CAPTURE_ENGINE_FIRST_SOURCE_PHOTO_STREAM
0xFFFFFFFB
 第一個影像數據流。
MF_CAPTURE_ENGINE_FIRST_SOURCE_VIDEO_STREAM
0xFFFFFFFC
 第一個視訊串流。
MF_CAPTURE_ENGINE_FIRST_SOURCE_AUDIO_STREAM
0xFFFFFFFD
 第一個音訊數據流。

[in] pMediaType

指定輸出數據流所需格式的 IMFMediaType 指標。 格式的詳細數據將取決於擷取接收。

  • 相片接收：與 Windows 圖像處理元件 相容的仍然影像格式， (WIC) 。
  • 預覽接收：未壓縮的音訊或視訊格式。
  • 錄製接收：將寫入輸出檔的音訊或視訊格式。

[in] pAttributes

IMFAttributes 介面的指標。 對於壓縮的數據流，您可以使用此參數來設定編碼器。 此參數也可以是 NULL。

針對預覽接收，請將此參數設定為 NULL。

[out] pdwSinkStreamIndex

接收擷取接收上新數據流的索引。 請注意，此索引不一定符合 dwSourceStreamIndex 的值。

傳回值

這個方法可以傳回其中一個值。

傳回碼 描述
S_OK
 成功。
MF_E_INVALIDMEDIATYPE
 pMediaType 中指定的格式對這個擷取接收無效。
MF_E_INVALIDSTREAMNUMBER
 dwSourceStreamIndex 參數無效，或指定的來源數據流已經連線到此接收。

規格需求

需求 值
最低支援的用戶端 Windows 8 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2012 [僅限傳統型應用程式]
目標平台 Windows
標頭 mfcaptureengine.h

另請參閱

IMFCaptureSink