Método IMediaEvent::GetEvent (control.h)

Artículo
07/28/2023

[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
S_OK	Correcto.
E_ABORT	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

Consulte también

Códigos de error y éxito

IMediaEvent (interfaz)

IMediaEventEx

Share via