FilterInputMessage

Appelé par PresentationHost.exe chaque fois qu’un message est reçu, sauf si E_NOTIMPL est retourné.

Syntaxe

HRESULT FilterInputMessage( [in] MSG* pMsg ) ;

Paramètres

pMsg

[in] Le message WM_INPUT envoyé à la fenêtre qui reçoit une entrée brute.

Valeur de propriété/valeur de retour

HRESULT :

S_OK : le filtre n’a pas traité le message et un traitement ultérieur peut se produire.

S_FALSE : le filtre a traité ce message et aucun traitement supplémentaire ne doit se produire.

E_NOTIMPL : si cette valeur est retournée, FilterInputMessage n’est pas appelé à nouveau. Cela peut être retourné par une application hôte qui souhaite uniquement fournir des interfaces utilisateur personnalisées de progression et d’erreur à PresentationHost.exe tout en ne voulant pas que des messages d’entrée brute soient transférés à partir de PresentationHost.exe.

Remarques

PresentationHost.exe est la cible de différents appareils d’entrée brutes, notamment le clavier, les souris et les commandes à distance. Parfois, le comportement dans l’application hôte dépend de l’entrée qui serait autrement consommée par PresentationHost.exe. Par exemple, une application hôte peut dépendre de la réception de certains messages d’entrée pour déterminer s’il faut afficher ou non des éléments d’interface utilisateur spécifiques.

Pour permettre à l’application hôte de recevoir les messages d’entrée nécessaires pour fournir ces comportements, PresentationHost.exe transfère les messages d’entrée brut appropriés à l’application hébergée en appelant FilterInputMessage.

L’application hébergée reçoit des messages d’entrée bruts en s’inscrivant auprès de l’ensemble d’appareils d’entrée bruts (appareils d’interface humaine) retournés par GetRawInputDevices.

Voir aussi

• message WM_INPUT