Compartilhar via

Método IMFCaptureEngineOnEventCallback::OnEvent (mfcaptureengine.h)

  • Artigo

Chamado pelo mecanismo de captura para notificar a aplicação de um evento de captura.

Sintaxe

HRESULT OnEvent(
  [in] IMFMediaEvent *pEvent
);

Parâmetros

[in] pEvent

Um ponteiro para a interface IMFMediaEvent . Use essa interface para obter informações sobre o evento, conforme descrito em Comentários.

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

Para obter o tipo de evento, chame IMFMediaEvent::GetExtendedType. Esse método retorna um dos GUIDs a seguir.

GUID Descrição
MF_CAPTURE_ENGINE_ALL_EFFECTS_REMOVED O método IMFCaptureSource::RemoveAllEffects foi concluído.
MF_CAPTURE_ENGINE_CAMERA_STREAM_BLOCKED A captura de vídeo foi bloqueada pelo driver.
MF_CAPTURE_ENGINE_CAMERA_STREAM_UNBLOCKED A captura de vídeo foi restaurada pelo driver depois de ter sido bloqueada.
MF_CAPTURE_ENGINE_EFFECT_ADDED O método IMFCaptureSource::AddEffect foi concluído.
MF_CAPTURE_ENGINE_EFFECT_REMOVED O método IMFCaptureSource::RemoveEffect foi concluído.
MF_CAPTURE_ENGINE_ERROR Ocorreu um erro durante a captura.
MF_CAPTURE_ENGINE_INITIALIZED O método IMFCaptureEngine::Initialize foi concluído.
MF_CAPTURE_ENGINE_PHOTO_TAKEN O método IMFCaptureEngine::TakePhoto foi concluído.
MF_CAPTURE_ENGINE_PREVIEW_STARTED O método IMFCaptureEngine::StartPreview foi concluído.
MF_CAPTURE_ENGINE_PREVIEW_STOPPED O método IMFCaptureEngine::StopPreview foi concluído.
MF_CAPTURE_ENGINE_RECORD_STARTED O método IMFCaptureEngine::StartRecord foi concluído.
MF_CAPTURE_ENGINE_RECORD_STOPPED O método IMFCaptureEngine::StopRecord foi concluído.
MF_CAPTURE_SINK_PREPARED O método IMFCaptureSink::P repare foi concluído.
MF_CAPTURE_SOURCE_CURRENT_DEVICE_MEDIA_TYPE_SET O método IMFCaptureSource::SetCurrentDeviceMediaType foi concluído.
 

Esse método pode ser chamado de um thread de trabalho. A implementação deve ser thread-safe.

Para obter o código status do evento, chame IMFMediaEvent::GetStatus. Se o código status for um código de erro, ele indicará que a operação solicitada falhou.

Além disso, o objeto de evento especificado por pEvent pode conter qualquer um dos atributos a seguir.

Para obter atributos de evento, use a interface IMFAttributes , herdada por IMFMediaEvent .

Requisitos

   
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

IMFCaptureEngineOnEventCallback