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

  • 项目

通过加载任何必需的管道组件（例如编码器、视频处理器和媒体接收器）来准备捕获接收器。

语法

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