Filter-Eingabe-Nachricht

Wird von PresentationHost.exe aufgerufen, wenn eine Nachricht empfangen wird, es sei denn, dass E_NOTIMPL zurückgegeben wird.

Syntax

HRESULT FilterInputMessage( [in] MSG* pMsg ) ;

Die Parameter

pMsg

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

Eigenschaftswert/Rückgabewert

HRESULT:

S_OK – Der Filter hat die Nachricht nicht verarbeitet, und es kann eine weitere Verarbeitung erfolgen.

S_FALSE – Der Filter hat diese Nachricht verarbeitet, und es sollte keine weitere Verarbeitung erfolgen.

E_NOTIMPL – Wenn dieser Wert zurückgegeben wird, wird FilterInputMessage nicht erneut aufgerufen. Dies könnte von einer Host-Anwendung zurückgegeben werden, die nur daran interessiert ist, benutzerdefinierte Fortschritts- und Fehlerbenutzeroberflächen für PresentationHost.exe bereitzustellen und nicht daran interessiert ist, rohen Eingabemeldungen von PresentationHost.exeweiterzuleiten.

Bemerkungen

PresentationHost.exe ist das Ziel verschiedener Roheingabegeräte, darunter Tastatur, Mäuse und Fernbedienungen. Manchmal ist das Verhalten in der Hostanwendung von Eingaben abhängig, die andernfalls von PresentationHost.exeverarbeitet werden. Eine Hostanwendung kann beispielsweise davon abhängen, dass bestimmte Eingabemeldungen empfangen werden, um festzustellen, ob bestimmte Benutzeroberflächenelemente angezeigt werden sollen.

Damit die Hostanwendung die erforderlichen Eingabemeldungen empfängt, um diese Verhaltensweisen bereitzustellen, leitet PresentationHost.exe geeignete unformatierte Eingabemeldungen durch Aufrufen von FilterInputMessage an die gehostete Anwendung weiter.

Die gehostete Anwendung empfängt Roh-Eingabemeldungen, indem sie sich bei den von GetRawInputDevices zurückgegebenen Roheingabegeräten (Human Interface Devices) registriert.

Siehe auch

• WM_INPUT Nachricht