Freigeben über


FilterInputMessage

Wird von der Datei PresentationHost.exe aufgerufen, wenn eine Meldung empfangen wird, sofern nicht E_NOTIMPL zurückgegeben wird.

HRESULT FilterInputMessage( [in] MSG* pMsg ) ;

Parameter

pMsg

[in] Die WM_INPUT-Meldung, die an das Fenster gesendet wird, das unformatierte Eingaben erhält.

Eigenschaftswert/Rückgabewert

HRESULT:

S_OK - Der Filter hat die Meldung nicht verarbeitet. Es können weitere Verarbeitungsschritte folgen.

S_FALSE - Der Filter hat diese Meldung verarbeitet. Es sollten keine weiteren Verarbeitungsschritte folgen.

E_NOTIMPL - Bei diesem Rückgabewert wird FilterInputMessage nicht wieder aufgerufen. Er kann von einer Hostanwendung zurückgegeben werden, die nur daran interessiert ist, benutzerdefinierte Fortschrittsbenutzeroberflächen und Fehlerbenutzeroberflächen für die Datei PresentationHost.exe bereitzustellen, und keinen Wert darauf legt, unformatierte Eingabemeldungen von der Datei PresentationHost.exe zu erhalten.

Hinweise

Die Datei PresentationHost.exe ist das Ziel verschiedener Geräte für die unformatierte Eingabe, einschließlich Tastatur, Mäuse und Fernsteuerungen. Manchmal hängt das Verhalten in der Hostanwendung von Eingaben ab, die andernfalls von der Datei PresentationHost.exe verarbeitet würden. Eine Hostanwendung kann unter Umständen nur anhand bestimmter Eingabemeldungen erkennen, ob spezifische Benutzeroberflächen-Elemente angezeigt werden sollen oder nicht.

Damit die Hostanwendungen die für die Implementierung dieses Verhaltens erforderlichen Eingabemeldungen empfangen können, leitet die Datei PresentationHost.exe entsprechende unformatierte Eingabemeldungen an die gehostete Anwendung weiter, indem sie FilterInputMessage aufruft.

Die gehostete Anwendung empfängt unformatierte Eingabemeldungen, indem sie sich bei der Gruppe von Geräten für die unformatierte (Human Interface Devices) registriert, die von GetRawInputDevices zurückgegeben werden.

Siehe auch

Weitere Ressourcen

WM_INPUT-Benachrichtigung