FilterInputMessage

  • Articolo

Chiamato da PresentationHost.exe ogni volta che viene ricevuto un messaggio, a meno che non venga restituito E_NOTIMPL.

Sintassi

HRESULT FilterInputMessage( [in] MSG* pMsg ) ;

Parametri

pMsg

[in] Messaggio WM_INPUT inviato alla finestra che sta ricevendo l'input non elaborato.

Valore proprietà/Valore restituito

HRESULT:

S_OK: il filtro non ha elaborato il messaggio e l'elaborazione può proseguire.

S_FALSE: il filtro ha elaborato questo messaggio e non viene eseguita alcuna ulteriore elaborazione.

E_NOTIMPL: se questo valore viene restituito, FilterInputMessage non viene chiamato di nuovo. È possibile che venga restituito da un'applicazione host interessata solo a fornire interfacce utente personalizzate di stato ed errore a PresentationHost.exe e non a ricevere messaggi di input non elaborato da PresentationHost.exe.

Osservazioni

PresentationHost.exe è la destinazione di vari dispositivi di input non elaborato, tra cui tastiere, mouse e telecomandi. In alcuni casi, il comportamento nell'applicazione host dipende dall'input che, in caso contrario, verrebbe usato da PresentationHost.exe. Ad esempio, la visualizzazione di specifici elementi dell'interfaccia utente da parte di un'applicazione host può dipendere dalla ricezione di determinati messaggi di input.

Per consentire all'applicazione host di ricevere i messaggi di input necessari per fornire questi comportamenti, PresentationHost.exe inoltra i messaggi di input non elaborati appropriati all'applicazione ospitata chiamando FilterInputMessage.

L'applicazione ospitata riceve messaggi di input non elaborati registrando con il set di dispositivi di input non elaborati (dispositivi di interfaccia umana) restituiti da GetRawInputDevices.

Vedi anche