FilterInputMessage

除非返回 E_NOTIMPL,否则将在收到消息时由 PresentationHost.exe 进行调用。

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 将相应的原始输入消息转发到承载的应用程序。

承载的应用程序通过向 GetRawInputDevices 返回的原始输入设备集(人体学接口设备)注册来接收原始输入消息。

请参见

其他资源

WM_INPUT Notification