FiltreraInmatningsMeddelande

Anropas av PresentationHost.exe när ett meddelande tas emot, såvida inte E_NOTIMPL returneras.

Syntax

HRESULT FilterInputMessage( [in] MSG* pMsg ) ;

Parameterar

pMsg

[i] Det WM_INPUT meddelande som skickas till fönstret som får råa indata.

Egenskapsvärde/returvärde

HRESULT:

S_OK – Filtret bearbetade inte meddelandet och ytterligare bearbetning kan ske.

S_FALSE – Filtret bearbetade det här meddelandet och ingen ytterligare bearbetning ska ske.

E_NOTIMPL – Om det här värdet returneras anropas inte FilterInputMessage igen. Detta kan returneras från ett värdprogram som bara är intresserat av att tillhandahålla anpassade förlopps- och felanvändargränssnitt för att PresentationHost.exe inte är intresserad av att vidarebefordra råa indatameddelanden från PresentationHost.exe.

Anmärkningar

PresentationHost.exe är målobjektet för olika råindataenheter, inklusive tangentbord, möss och fjärrkontroller. Ibland är beteendet i värdprogrammet beroende av indata som annars skulle förbrukas av PresentationHost.exe. Ett värdprogram kan till exempel vara beroende av att ta emot vissa indatameddelanden för att avgöra om specifika användargränssnittselement ska visas eller inte.

För att värdprogrammet ska kunna ta emot de indatameddelanden som krävs för att tillhandahålla dessa beteenden vidarebefordrar PresentationHost.exe lämpliga råa indatameddelanden till det värdbaserade programmet genom att anropa FilterInputMessage.

Det värdbaserade programmet tar emot råa indatameddelanden genom att registrera med den uppsättning raw-indataenheter (Human Interface Devices) som returneras av GetRawInputDevices.

Se även

• WM_INPUT-meddelande