FilterInputMessage
Mise à jour : novembre 2007
Appelé par PresentationHost.exe toutes les fois qu'un message est reçu à moins que E_NOTIMPL ne soit retourné.
HRESULT FilterInputMessage( [in] MSG* pMsg ) ;
Paramètres
pMsg
[entrée] Le message WM_INPUT envoyé à la fenêtre qui obtient l'entrée brute.
Valeur de propriété/valeur de retour
HRESULT :
S_OK - Le filtre n'a pas traité le message et le traitement peut se poursuivre.
S_FALSE - Le filtre a traité ce message et aucun autre traitement ne doit se produire.
E_NOTIMPL. Si cette valeur est retournée, FilterInputMessage n'est plus appelé. Cette valeur peut être retournée d'une application hôte intéressée uniquement pour fournir une progression personnalisée et des interfaces d'erreurs d'utilisateur à PresentationHost.exe, et non pas pour finir en messages d'entrées brutes transférés depuis PresentationHost.exe.
Notes
PresentationHost.exe est la cible de différents périphériques d'entrées brutes, y compris le clavier, la souris et les contrôles à distance. Le comportement dans l'application hôte est parfois dépendant 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 d'afficher ou non les éléments spécifiques de l'interface utilisateur.
Pour permettre à l'application hôte de recevoir les messages d'entrée nécessaires pour fournir ces comportements, PresentationHost.exe transfère des messages d'entrées brutes appropriés à l'application hébergée en appelant FilterInputMessage.
L'application hébergée reçoit des messages d'entrées brutes en s'enregistrant avec le jeu de périphériques d'entrées brutes (périphériques d'interface utilisateur) retourné par GetRawInputDevices.