Compartir a través de


FilterInputMessage

Actualización: noviembre 2007

Lo llama PresentationHost.exe cada vez que se recibe un mensaje, a menos que se devuelva E_NOTIMPL.

HRESULT FilterInputMessage( [in] MSG* pMsg ) ;

Parámetros

pMsg

[in] El mensaje WM_INPUT enviado a la ventana que obtiene entrada sin formato.

Valor de propiedad y valor devuelto

HRESULT:

S_OK: el filtro no procesó el mensaje y puede que se realice algún procesamiento ulterior.

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

E_NOTIMPL: si se devuelve este valor, no se llama de nuevo a FilterInputMessage. Este valor puede devolverlo una aplicación host que sólo esté interesada en proporcionar interfaces de usuario personalizadas de progreso y de errores a PresentationHost.exe y no está interesada en recibir mensajes de entrada sin formato reenviados por PresentationHost.exe.

Comentarios

PresentationHost.exe es el destino de varios dispositivos de entrada sin formato, incluidos el teclado, el mouse y los dispositivos de control remoto. A veces, el comportamiento de la aplicación host depende de la entrada que, en otro caso, utilizaría PresentationHost.exe. Por ejemplo, una aplicación host puede depender de recibir ciertos mensajes de entrada para determinar si debe mostrar o no algunos elementos concretos 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 formato apropiados a la aplicación hospedada llamando a FilterInputMessage.

La aplicación hospedada recibe los mensajes de entrada sin formato registrándose con el conjunto de dispositivos de entrada sin formato (dispositivos de interfaz de usuario) devueltos por GetRawInputDevices.

Vea también

Otros recursos

WM_INPUT Notification