共用方式為

IMFCaptureSink：:P repare 方法 (mfcaptureengine.h)

  • 發行項

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

Syntax

HRESULT Prepare();

傳回值

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

傳回碼 描述
S_OK
 成功。
MF_E_INVALIDREQUEST
 無效的要求

備註

呼叫此方法是選擇性的。 此方法可讓應用程式有機會在使用管線元件之前設定管線元件。 方法是非同步的。 如果方法傳回成功碼，呼叫端將會透過IMFCaptureEngineOnEventCallback：：OnEvent方法收到MF_CAPTURE_SINK_PREPARED事件。 收到此事件之後，請呼叫 IMFCaptureSink：：GetService 來設定個別元件。

呼叫此方法之前，請新增至少一個數據流來設定擷取接收。 若要新增數據流，請呼叫 IMFCaptureSink：：AddStream。

如果擷取接收正在使用中， Prepare 方法就會失敗。 例如，如果擷取引擎目前正在預覽，在預覽接收上呼叫 Prepare 會失敗。

規格需求

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

另請參閱

IMFCaptureSink