Método IMediaEventEx::SetNotifyWindow (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 SetNotifyWindow método registra una ventana para procesar las notificaciones de eventos.

Sintaxis

HRESULT SetNotifyWindow(
  [in] OAHWND   hwnd,
  [in] long     lMsg,
  [in] LONG_PTR lInstanceData
);

Parámetros

[in] hwnd

Controle la ventana o NULL para dejar de recibir mensajes de eventos.

[in] lMsg

Mensaje de ventana que se va a pasar como notificación.

[in] lInstanceData

Valor que se va a pasar como parámetro lParam para el mensaje lMsg .

Valor devuelto

Devuelve S_OK si se ejecuta correctamente o E_INVALIDARG si el parámetro hwnd no es un identificador válido para una ventana.

Observaciones

Este método designa una ventana que procesará las notificaciones de eventos. Cada vez que el Administrador de gráficos de filtros coloca un evento en la cola de eventos, también publicará un mensaje en la ventana designada. El parámetro hwnd especifica la ventana y el parámetro lMsg especifica el mensaje. La aplicación debe definir un mensaje de ventana privada para este fin. El parámetro lParam del mensaje se establece en el valor de lInstanceData y el parámetro wParam se establece en cero.

Cuando la ventana recibe el mensaje, debe llamar al método IMediaEvent::GetEvent para recuperar el evento. Los eventos son asincrónicos, por lo que la cola puede contener varios eventos (o ninguno). Llame repetidamente a GetEvent hasta que devuelva un código de error.

Requisitos

Consulte también

Códigos de error y éxito

IMediaEventEx (interfaz)