FilterInputMessage

E_NOTIMPL döndürülmediği takdirde ileti her alındığında PresentationHost.exe çağırılır.

Sözdizimi

HRESULT FilterInputMessage( [in] MSG* pMsg ) ;  

Parametreler

pMsg

'ndaki Ham giriş alan pencereye gönderilen WM_INPUT iletisi.

Özellik Değeri/Dönüş Değeri

HRESULT

S_OK-filtre iletiyi işlemedi ve başka işlemler meydana gelebilir.

S_FALSE-filtre bu iletiyi işledi ve başka bir işlem gerçekleşmemelidir.

E_NOTIMPL – Bu değer döndürülürse FilterInputMessage yeniden çağrılmaz. Bu, yalnızca özel ilerleme sağlamak isteyen bir konak uygulamasından döndürülebilir ve PresentationHost.exe ' a yönelik kullanıcı arabirimlerinin, ham giriş iletilerinin PresentationHost.exe iletilmek üzere ilgilenmiyor.

Açıklamalar

PresentationHost.exe, klavye, fare ve uzak denetimler dahil olmak üzere çeşitli ham giriş cihazlarının hedefidir. Bazen, ana bilgisayar uygulamasındaki davranış PresentationHost.exe tarafından başka bir şekilde tüketilen girişe bağımlıdır. Örneğin, bir konak uygulama belirli kullanıcı arabirimi öğelerinin görüntülenip görüntülenmeyeceğini anlamak için belirli giriş iletilerinin alınmasına bağlı olabilir.

Konak uygulamanın bu davranışları sağlamak üzere gerekli giriş iletilerini almasına izin vermek için, PresentationHost.exe FilterInputMessage' ı çağırarak, barındırılan uygulamaya uygun ham giriş iletilerini iletir.

Barındırılan uygulama, Getpwınputdevicestarafından döndürülen ham giriş aygıtları (Insan arabirim aygıtları) kümesiyle kaydederek ham giriş iletilerini alır.

Ayrıca bkz.