FilterInputMessage

Llamado por PresentationHost.exe cada vez que se recibe un mensaje, a menos que E_NOTIMPL sea devuelto.

Sintaxis

HRESULT FilterInputMessage( [in] MSG* pMsg ) ;

Parámetros

pMsg

[in] Mensaje de WM_INPUT enviado a la ventana que recibe la entrada sin procesar.

Valor de propiedad y valor devuelto

HRESULT:

S_OK: el filtro no procesó el mensaje y puede producirse un procesamiento adicional.

S_FALSE: el filtro procesó este mensaje y no debe producirse ningún procesamiento adicional.

E_NOTIMPL – si se devuelve este valor, no se vuelve a llamar a FilterInputMessage. Esto puede devolverse desde una aplicación host que solo está interesada en proporcionar interfaces de usuario de error y progreso personalizadas para PresentationHost.exe no está interesado en reenviar mensajes de entrada sin procesar desde PresentationHost.exe.

Observaciones

PresentationHost.exe es el destino de varios dispositivos de entrada sin procesar, como teclado, ratones y controles remotos. A veces, el comportamiento de la aplicación host depende de una entrada que, de otra manera, sería consumida por PresentationHost.exe. Por ejemplo, una aplicación host puede depender de recibir determinados mensajes de entrada para determinar si se van a mostrar elementos específicos de la interfaz de usuario.

Para permitir que la aplicación host reciba los mensajes de entrada necesarios para proporcionar estos comportamientos, PresentationHost.exe reenvía los mensajes de entrada sin procesar adecuados a la aplicación hospedada llamando a FilterInputMessage.

La aplicación hospedada recibe mensajes de entrada sin procesar mediante el registro con el conjunto de dispositivos de entrada sin procesar (dispositivos de interfaz humana) devueltos por GetRawInputDevices.

Consulte también

• mensaje de WM_INPUT