Метод IMediaEventEx::SetNotifyWindow (control.h)
[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует использовать в новом коде MediaPlayer, IMFMediaEngine и аудио/видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, в котором используются устаревшие API, чтобы по возможности использовать новые API.]
Метод SetNotifyWindow регистрирует окно для обработки уведомлений о событиях.
Синтаксис
HRESULT SetNotifyWindow(
[in] OAHWND hwnd,
[in] long lMsg,
[in] LONG_PTR lInstanceData
);
Параметры
[in] hwnd
Дескриптор окна или ЗНАЧЕНИЕ NULL , чтобы прекратить получение сообщений о событиях.
[in] lMsg
Сообщение окна, передаваемого в качестве уведомления.
[in] lInstanceData
Значение, передаваемое в качестве параметра lParam для сообщения lMsg .
Возвращаемое значение
Возвращает S_OK в случае успешного выполнения или E_INVALIDARG, если параметр hwnd не является допустимым дескриптором для окна.
Комментарии
Этот метод определяет окно, которое будет обрабатывать уведомления о событиях. Всякий раз, когда диспетчер фильтров графов помещает событие в очередь событий, он также отправляет сообщение в указанное окно. Параметр hwnd указывает окно, а параметр lMsg — сообщение. Для этой цели приложение должно определить личное сообщение окна. Параметру lParam сообщения присваивается значение lInstanceData, а для параметра wParam — нулевое значение.
Когда окно получает сообщение, оно должно вызвать метод IMediaEvent::GetEvent для получения события. События являются асинхронными, поэтому очередь может содержать несколько событий (или ни одного). Вызывайте Метод GetEvent несколько раз, пока не будет возвращен код ошибки.
Требования
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | control.h (включая Dshow.h) |
| Библиотека | Strmiids.lib |