FilterInputMessage
Вызывается программой PresentationHost.exe всякий раз при получении сообщения, пока не будет возвращено E_NOTIMPL.
Синтаксис
HRESULT FilterInputMessage( [in] MSG* pMsg ) ;
Параметры
pMsg
[in] Сообщение WM_INPUT отправлено в окно, которое получает необработанные входные данные.
Значение свойства, возвращаемое значение
HRESULT:
S_OK — фильтр не обработал сообщение, и дальнейшая обработка разрешена.
S_FALSE — фильтр обработал это сообщение, и дальнейшая обработка не выполняется.
E_NOTIMPL — Если это значение возвращается, FilterInputMessage не вызывается повторно. Это значение может быть возвращено из ведущего приложения, которое заинтересовано только в предоставлении пользовательских интерфейсов хода выполнения и ошибок в PresentationHost.exe и не заинтересовано в перенаправлении необработанных входных сообщений из PresentationHost.exe.
Примечания
PresentationHost.exe является целевым объектом различных необработанных устройств ввода, включая клавиатуру, мышь и удаленное управление. В некоторых случаях поведение в ведущем приложении зависит от входных данных, которые в противном случае будет использоваться PresentationHost.exe. Например, ведущее приложение может зависеть от получения определенных входных сообщений, чтобы определить необходимость отображения конкретных элементов пользовательского интерфейса.
Чтобы разрешить ведущему приложению получать необходимые входные сообщения для предоставления этих расширений функциональности, PresentationHost.exe перенаправляет соответствующие необработанные входные сообщения в размещенное приложение путем вызова FilterInputMessage.
Размещенное приложение получает необработанные входные сообщения путем регистрации в наборе необработанных устройств ввода (HID-устройств) возвращенные GetRawInputDevices.