Método IMFCaptureEngineOnEventCallback::OnEvent (mfcaptureengine.h)
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 |