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

  • Artículo

Lo llama el motor de captura para notificar a la aplicación un evento de captura.

Sintaxis

HRESULT OnEvent(
  [in] IMFMediaEvent *pEvent
);

Parámetros

[in] pEvent

Puntero a la interfaz IMFMediaEvent . Use esta interfaz para obtener información sobre el evento, como se describe en Comentarios.

Valor devuelto

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Para obtener el tipo de evento, llame a IMFMediaEvent::GetExtendedType. Este método devuelve uno de los siguientes GUID.

GUID Descripción
MF_CAPTURE_ENGINE_ALL_EFFECTS_REMOVED Se completó el método IMFCaptureSource::RemoveAllEffects .
MF_CAPTURE_ENGINE_CAMERA_STREAM_BLOCKED El controlador ha bloqueado la captura de vídeo.
MF_CAPTURE_ENGINE_CAMERA_STREAM_UNBLOCKED El controlador ha restaurado la captura de vídeo después de haber sido bloqueada.
MF_CAPTURE_ENGINE_EFFECT_ADDED Se completó el método IMFCaptureSource::AddEffect .
MF_CAPTURE_ENGINE_EFFECT_REMOVED Se completó el método IMFCaptureSource::RemoveEffect .
MF_CAPTURE_ENGINE_ERROR Error durante la captura.
MF_CAPTURE_ENGINE_INITIALIZED Se completó el método IMFCaptureEngine::Initialize .
MF_CAPTURE_ENGINE_PHOTO_TAKEN Se completó el método IMFCaptureEngine::TakePhoto .
MF_CAPTURE_ENGINE_PREVIEW_STARTED Se completó el método IMFCaptureEngine::StartPreview .
MF_CAPTURE_ENGINE_PREVIEW_STOPPED Se completó el método IMFCaptureEngine::StopPreview .
MF_CAPTURE_ENGINE_RECORD_STARTED Se completó el método IMFCaptureEngine::StartRecord .
MF_CAPTURE_ENGINE_RECORD_STOPPED Se completó el método IMFCaptureEngine::StopRecord .
MF_CAPTURE_SINK_PREPARED Se completó el método IMFCaptureSink::P repare .
MF_CAPTURE_SOURCE_CURRENT_DEVICE_MEDIA_TYPE_SET Se completó el método IMFCaptureSource::SetCurrentDeviceMediaType .
 

Se puede llamar a este método desde un subproceso de trabajo. La implementación debe ser segura para subprocesos.

Para obtener el código de estado del evento, llame a IMFMediaEvent::GetStatus. Si el código de estado es un código de error, indica que se produjo un error en la operación solicitada.

Además, el objeto de evento especificado por pEvent puede contener cualquiera de los atributos siguientes.

Para obtener atributos de evento, use la interfaz IMFAttributes , que IMFMediaEvent hereda.

Requisitos

   
Cliente mínimo compatible Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado mfcaptureengine.h

Consulte también

IMFCaptureEngineOnEventCallback