Метод IVideoWindow::p ut_MessageDrain (control.h)

Статья
07/28/2023

[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует использовать в новом коде MediaPlayer, IMFMediaEngine и аудио/видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, в котором используются устаревшие API, чтобы по возможности использовать новые API.]

Метод put_MessageDrain задает окно для получения сообщений мыши и клавиатуры из окна видео.

Синтаксис

HRESULT put_MessageDrain(
  [in] OAHWND Drain
);

Параметры

[in] Drain

Дескриптор окна в виде значения OAHWND .

Возвращаемое значение

Возможные возвращаемые значения:

Код возврата	Описание
S_OK	Успешно.
VFW_E_NOT_CONNECTED	Фильтр отрисовщика видео не подключен.

Если значение Drain не равно NULL, отрисовщик видео перенаправит определенные сообщения в указанное окно с помощью функции PostMessage . Пересылаемые сообщения могут зависеть от используемого отрисовщика видео. Отрисовщик видео и отрисовщик смешивания видео (VMR) перенаправляют следующие сообщения:

WM_CHAR
WM_DEADCHAR
WM_KEYDOWN
WM_KEYUP
WM_LBUTTONDBLCLK
WM_LBUTTONDOWN
WM_LBUTTONUP
WM_MBUTTONDBLCLK
WM_MBUTTONDOWN
WM_MBUTTONUP
WM_MOUSEACTIVATE
WM_MOUSEMOVE
WM_NCLBUTTONDBLCLK
WM_NCLBUTTONDOWN
WM_NCLBUTTONUP
WM_NCMBUTTONDBLCLK
WM_NCMBUTTONDOWN
WM_NCMBUTTONUP
WM_NCMOUSEMOVE
WM_NCRBUTTONDBLCLK
WM_NCRBUTTONDOWN
WM_NCRBUTTONUP
WM_RBUTTONDBLCLK
WM_RBUTTONDOWN
WM_RBUTTONUP
WM_SYSCHAR
WM_SYSDEADCHAR
WM_SYSKEYDOWN
WM_SYSKEYUP

Окно очистки сообщений не обязательно должно быть родительским для окна видео, поэтому этот метод можно использовать в полноэкранных приложениях.

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	control.h (включая Dshow.h)
Библиотека	Strmiids.lib

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

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

Интерфейс IVideoWindow

IVideoWindow::get_MessageDrain