Compartilhar via


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

Captura uma imagem parada do fluxo de vídeo.

Sintaxe

HRESULT TakePhoto();

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Antes de chamar esse método, configure o coletor de fotos chamando IMFCaptureSink::AddStream. Para obter um ponteiro para o coletor de fotos, 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_PHOTO_TAKEN 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 .

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