FilterInputMessage
Chamado por PresentationHost.exe sempre que uma mensagem é recebida a não ser que E_NOTIMPL é retornado.
HRESULT FilterInputMessage( [in] MSG* pMsg ) ;
Parâmetros
pMsg
[in] A mensagem WM_INPUT enviada para a janela que está recebendo a entrada bruta.
Valor de Propriedade/Valor Retornado
HRESULT:
S_OK - O filtro não processou a mensagem e processamento adicional pode ocorrer.
S_FALSE - O filtro processou esta mensagem e nenhum processamento adicional deve ocorrer.
E_NOTIMPL – Se esse valor é retornado, FilterInputMessage não é chamado novamente. Isso pode ser retornado de um aplicativo hospedeiro que só está interessado em fornecer interfaces do usuário personalizadas de erro e de andamento para o PresentationHost.exe e não está interessada em receber mensagens de entrada bruta do PresentationHost.exe.
Comentários
PresentationHost.exe é o destino de vários dispositivos de entrada não processada, incluindo teclado, mouse e controles remotos. Às vezes, o comportamento no aplicativo host é dependente de entrada caso contrário poderia ser consumida por PresentationHost.exe. Por exemplo, um aplicativo host pode depender recebendo determinadas mensagens de entrada para determinar se deve ou não exibir elementos de interface de usuário específico.
Para permitir que o aplicativo hospedeiro receba as mensagens de entrada necessárias para fornecer esses comportamentos, o PresentationHost.exe encaminha as mensagens de entrada não processada apropriadas para o aplicativo hospedado chamando FilterInputMessage.
O aplicativo hospedado recebe as mensagens de entrada não processada ao se registrar com o conjunto de dispositivos de entrada bruta (Dispositivos de Interface Humana - HID) retornado por DispositivosDeReceberEntradaCrua.