Interfaz IMediaEvent (control.h)
[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.
La IMediaEvent interfaz contiene métodos para recuperar notificaciones de eventos y para invalidar el control predeterminado de eventos de Filter Graph Manager. La interfaz IMediaEventEx hereda esta interfaz y la extiende.
Filter Graph Manager implementa esta interfaz. Las aplicaciones pueden usarla para responder a eventos que se producen en el gráfico de filtros, como el final de una secuencia o un error de representación. Filtra los eventos posteriores al gráfico de filtros mediante la interfaz IMediaEventSink .
Para obtener más información sobre la notificación de eventos, vea Notificación de eventos en DirectShow. Para obtener una lista de las notificaciones de eventos definidas por el sistema, consulte Códigos de notificación de eventos.
Herencia
La interfaz IMediaEvent hereda de la interfaz IDispatch . IMediaEvent también tiene estos tipos de miembros:
Métodos
La interfaz IMediaEvent tiene estos métodos.
| IMediaEvent::CancelDefaultHandling El método CancelDefaultHandling cancela el control predeterminado de Filter Graph Manager para un evento especificado. La notificación de eventos se pasa a la aplicación. |
| IMediaEvent::FreeEventParams El método FreeEventParams libera recursos asociados a los parámetros de un evento. |
| IMediaEvent::GetEvent El método GetEvent recupera la siguiente notificación de eventos de la cola de eventos. |
| IMediaEvent::GetEventHandle El método GetEventHandle recupera un identificador de un evento de restablecimiento manual que permanece señalado mientras la cola contiene notificaciones de eventos. |
| IMediaEvent::RestoreDefaultHandling El método RestoreDefaultHandling restaura el control predeterminado de Filter Graph Manager para un evento especificado. |
| IMediaEvent::WaitForCompletion El método WaitForCompletion espera a que el gráfico de filtros represente todos los datos disponibles. El grafo de filtro debe estar en ejecución o se produce un error en el método. |
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | control.h (include Dshow.h) |