FilterInvoerBericht

Wordt door PresentationHost.exe aangeroepen wanneer een bericht wordt ontvangen, tenzij E_NOTIMPL wordt geretourneerd.

Syntaxis

HRESULT FilterInputMessage( [in] MSG* pMsg ) ;

Parameterwaarden

pMsg

[in] Het WM_INPUT bericht dat wordt verzonden naar het venster dat onbewerkte invoer krijgt.

Eigenschapswaarde/terugkeerwaarde

HRESULT:

S_OK: het filter heeft het bericht niet verwerkt en verdere verwerking kan plaatsvinden.

S_FALSE: het filter heeft dit bericht verwerkt en er mag geen verdere verwerking plaatsvinden.

E_NOTIMPL: als deze waarde wordt geretourneerd, wordt FilterInputMessage- niet opnieuw aangeroepen. Dit kan worden geretourneerd vanuit een hosttoepassing die alleen geïnteresseerd is in het leveren van aangepaste voortgang en foutgebruikersinterfaces aan PresentationHost.exe, maar niet geïnteresseerd is in het doorsturen van onbewerkte invoerberichten van PresentationHost.exe.

Opmerkingen

PresentationHost.exe is het doel van verschillende ruwe invoerapparaten, zoals toetsenborden, muizen en afstandsbedieningen. Soms is gedrag in de hosttoepassing afhankelijk van invoer die anders door PresentationHost.exezou worden gebruikt. Een hosttoepassing kan bijvoorbeeld afhankelijk zijn van het ontvangen van bepaalde invoerberichten om te bepalen of specifieke elementen van de gebruikersinterface wel of niet moeten worden weergegeven.

Als u wilt dat de hosttoepassing de benodigde invoerberichten ontvangt om dit gedrag te bieden, stuurt PresentationHost.exe de juiste ruwe invoerberichten door naar de gehoste toepassing door FilterInputMessageaan te roepen.

De gehoste toepassing ontvangt onbewerkte invoerberichten door zich te registreren bij de reeks onbewerkte invoerapparaten (Human Interface Devices) die worden geretourneerd door GetRawInputDevices.

Zie ook

• WM_INPUT bericht