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
| 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 (incluir Dshow.h) |
| Library | Strmiids.lib |