FilterInputMessage
Chiamato da PresentationHost.exe ogni volta che viene ricevuto un messaggio, a meno che non venga restituito E_NOTIMPL.
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 potrà essere eseguita un'ulteriore elaborazione.
S_FALSE: il filtro ha elaborato questo messaggio e non verrà eseguita alcuna ulteriore elaborazione.
E_NOTIMPL: se viene restituito questo valore, non viene nuovamente chiamato FilterInputMessage. È 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.
Note
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 utilizzato 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 questi comportamenti, mediante PresentationHost.exe vengono inviati messaggi di input non elaborato adatti all'applicazione ospitata chiamando FilterInputMessage.
L'applicazione ospitata riceve i messaggi di input non elaborato tramite la registrazione con l'insieme di dispositivi di input non elaborato (Human Interface Device, HID) restituito da GetRawInputDevices.