Mensagem de Entrada de Filtro

Chamado por PresentationHost.exe sempre que uma mensagem é recebida, a menos que E_NOTIMPL seja retornado.

Sintaxe

HRESULT FilterInputMessage( [in] MSG* pMsg ) ;

Parâmetros

pMsg

[in] A mensagem WM_INPUT dirigida à janela que está recebendo entrada não processada.

Valor da propriedade/valor de retorno

HRESULT:

S_OK - O filtro não processou a mensagem e pode ocorrer um processamento adicional.

S_FALSE - O filtro processou essa mensagem e nenhum processamento adicional deve ocorrer.

E_NOTIMPL – se esse valor for retornado, FilterInputMessage não será chamado novamente. Isso pode ser retornado de um aplicativo host que só está interessado em fornecer progresso personalizado e interfaces de usuário de erro para PresentationHost.exe não está interessado em ser encaminhado mensagens de entrada brutas de PresentationHost.exe.

Observações

PresentationHost.exe é o destino de vários dispositivos de entrada não processada, incluindo teclado, mouses e controles remotos. Às vezes, o comportamento no aplicativo host depende da entrada que, de outra forma, seria consumida por PresentationHost.exe. Por exemplo, um aplicativo host pode depender do recebimento de determinadas mensagens de entrada para determinar se os elementos específicos da interface do usuário devem ou não ser exibidos.

Para permitir que o aplicativo host receba as mensagens de entrada necessárias para fornecer esses comportamentos, PresentationHost.exe encaminha as mensagens de entrada brutas apropriadas para o aplicativo hospedado chamando FilterInputMessage.

O aplicativo hospedado recebe mensagens de entrada brutas registrando-se com o conjunto de dispositivos de entrada brutos (Dispositivos de Interface Humana) retornados por GetRawInputDevices.

Consulte também

• mensagem WM_INPUT