IMFCaptureSink 介面 (mfcaptureengine.h)

控制擷取接收,這是從擷取裝置接收一或多個數據流的物件。

繼承

IMFCaptureSink 介面繼承自 IUnknown 介面。 IMFCaptureSink 也有下列類型的成員:

方法

IMFCaptureSink 介面具有這些方法。

 
IMFCaptureSink::AddStream

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

取得這個擷取接收上數據流的輸出格式。
IMFCaptureSink::GetService

查詢介面的基礎接收寫入器物件。
IMFCaptureSink::P repare

載入任何必要的管線元件,例如編碼器、視訊處理器和媒體接收,以準備擷取接收。
IMFCaptureSink::RemoveAllStreams

從擷取接收中移除所有數據流。

備註

擷取引擎會建立下列擷取接收。

  • 相片接收。 編碼仍會圖像檔案。
  • 預覽接收。 預覽即時音訊或視訊。
  • 錄製接收。 建立壓縮的音訊/視訊檔案或壓縮的音訊/視訊數據流。
若要取得擷取接收的指標,請呼叫 IMFCaptureEngine::GetSink。 每個擷取接收都會實作衍生自 IMFCaptureSink 的介面。 呼叫 QueryInterface 以取得衍生介面的指標。
接收 介面
相片接收 IMFCapturePhotoSink
預覽接收 IMFCapturePreviewSink
錄製接收 IMFCaptureRecordSink
 

應用程式無法直接建立擷取接收。

如果影像串流原生媒體類型設定為 JPEG,則相片接收的格式應該與原生來源格式相同。 JPEG 原生類型僅限傳遞。

如果影像數據流原生類型設定為 JPEG,若要新增效果,請將影像數據流上的原生類型變更為未壓縮的視訊媒體類型 (,例如 NV12 或 RGB32) ,然後新增效果。

如果記錄數據流的原生類型為 H.264,則記錄接收應該使用相同的媒體類型進行設定。 H.264 原生類型僅供傳遞且無法譯碼。

公開 H.264 的記錄數據流不會公開任何其他類型。 H.264 記錄數據流無法與效果搭配使用。 若要新增效果,請改為使用 AddStream 將預覽數據流連接到 recordsink。

規格需求

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

另請參閱

媒體基礎介面