Compartilhar via


Método IMFCaptureEngine::StartPreview (mfcaptureengine.h)

Inicia a visualização.

Sintaxe

HRESULT StartPreview();

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
Êxito.
MF_E_INVALIDREQUEST
O coletor de visualização não foi inicializado.

Comentários

Antes de chamar esse método, configure o coletor de visualização chamando IMFCaptureSink::AddStream. Para obter um ponteiro para o coletor de visualização, chame IMFCaptureEngine::GetSink.

Esse método é assíncrono. Se o método retornar um código de êxito, o chamador receberá um evento MF_CAPTURE_ENGINE_PREVIEW_STARTED por meio do método IMFCaptureEngineOnEventCallback::OnEvent . A operação pode falhar de forma assíncrona depois que o método for bem-sucedido. Nesse caso, o código de erro é transmitido por meio do método OnEvent .

Depois que o coletor de visualização for configurado, você poderá parar e iniciar a visualização chamando IMFCaptureEngine::StopPreview e IMFCaptureEngine::StartPreview.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho mfcaptureengine.h

Confira também

IMFCaptureEngine