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.

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

Consulte también

Códigos de error y éxito

IMediaEvent (interfaz)

IMediaEventEx