Метод 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 несколько раз, пока не будет возвращен код ошибки.

Требования

См. также раздел

Коды ошибок и успешности

Интерфейс IMediaEventEx