IMFCaptureEngine::StartPreview 方法 (mfcaptureengine.h)

开始预览。

语法

HRESULT StartPreview();

返回值

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

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

注解

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

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

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

要求

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

另请参阅

IMFCaptureEngine