IMFCaptureEngine：：StartPreview 方法 (mfcaptureengine.h)

  • 项目

开始预览。

语法

HRESULT StartPreview();

返回值

此方法可以返回其中一个值。

返回代码 说明
S_OK
 成功。
MF_E_INVALIDREQUEST
 预览接收器未初始化。

注解

在调用此方法之前，请通过调用 IMFCaptureSink：：AddStream 来配置预览接收器。 若要获取指向预览接收器的指针，请调用 IMFCaptureEngine：：GetSink。

此方法是异步方法。 如果该方法返回成功代码，则调用方将通过 IMFCaptureEngineOnEventCallback：：OnEvent 方法接收MF_CAPTURE_ENGINE_PREVIEW_STARTED事件。 方法成功后，操作可能会异步失败。 如果是，则通过 OnEvent 方法传递错误代码。

配置预览接收器后，可以通过调用 IMFCaptureEngine：：StopPreview 和 IMFCaptureEngine：：StartPreview 来停止和启动预览版。

要求

要求 值
最低受支持的客户端 Windows 8 [仅限桌面应用]
最低受支持的服务器 Windows Server 2012 [仅限桌面应用]
目标平台 Windows
标头 mfcaptureengine.h

另请参阅

IMFCaptureEngine