Compartir a través de


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)

Consulte también

IDispatch