Método IMediaEvent::GetEvent (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.
El GetEvent método recupera la siguiente notificación de eventos de la cola de eventos.
Sintaxis
HRESULT GetEvent(
[out] long *lEventCode,
[out] LONG_PTR *lParam1,
[out] LONG_PTR *lParam2,
[in] long msTimeout
);
Parámetros
[out] lEventCode
Puntero a una variable que recibe el código de evento.
[out] lParam1
Puntero a una variable que recibe el primer parámetro de evento.
[out] lParam2
Puntero a una variable que recibe el segundo parámetro de evento.
[in] msTimeout
Intervalo de tiempo de espera, en milisegundos. Use INFINITE para bloquear hasta que haya un evento.
Valor devuelto
Devuelve un valor HRESULT . Entre los valores posibles se incluyen los que se muestran en la tabla siguiente.
| Código devuelto | Descripción |
|---|---|
|
Correcto. |
|
Tiempo de espera agotado. |
Observaciones
Si no hay ningún evento en la cola, este método espera hasta milisegundos msTimeout para que llegue un evento. Evite usar un intervalo de tiempo de espera de INFINITE, ya que los subprocesos no pueden procesar ningún mensaje mientras esperan en GetEvent. Si llama desde el mismo subproceso GetEvent que procesa los mensajes de Windows, especifique solo tiempos de espera pequeños para seguir respondiendo a la entrada del usuario.
Después de llamar a GetEvent, llame al método IMediaEvent::FreeEventParams para liberar los recursos asignados para los parámetros del evento.
Para obtener una lista de los códigos de notificación y los valores de los parámetros de evento, consulte Códigos de notificación de eventos.
Dado que este método quita el evento de la cola de eventos del grafo de filtro, no hay ninguna manera de que varios clientes supervisen eventos del mismo gráfico.
Requisitos
| 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) |
| Library | Strmiids.lib |