次の方法で共有

FilterInputMessage

  • [アーティクル]

E_NOTIMPL が返されない限り、メッセージを受信するたびに PresentationHost.exe によって呼び出されます。

構文

HRESULT FilterInputMessage( [in] MSG* pMsg ) ;

パラメーター

pMsg

[in] 未加工入力を取得するウィンドウに送信される WM_INPUT メッセージ。

プロパティ値/戻り値

HRESULT:

S_OK - フィルターはメッセージを処理せず、それ以降の処理は実行されることがあります。

S_FALSE - フィルターはこのメッセージを処理しました。それ以降の処理は実行されません。

E_NOTIMPL – この値が返される場合、FilterInputMessage は再度呼び出されません。 この値は、カスタムの進行状況の提供のみを対象とするホスト アプリケーションから返されることがあります。PresentationHost.exe へのエラー ユーザー インターフェイスは、PresentationHost.exe からの未加工の入力メッセージの転送を対象としていません。

Remarks

PresentationHost.exe は、キーボード、マウス、およびリモート コントロールなどのさまざまな未加工入力デバイスのターゲットになります。 場合によって、ホスト アプリケーションでの動作は PresentationHost.exe で使用される入力に依存します。 たとえば、ホスト アプリケーションは、特定のユーザー インターフェイス要素を表示するかどうかを判断するために、特定の入力メッセージの受信に依存することがあります。

これらの動作を提供するためにホスト アプリケーションが必要な入力メッセージを受信できるようにするため、PresentationHost.exe では、FilterInputMessage を呼び出すことで、ホストされているアプリケーションに適切な未加工の入力メッセージが転送されます。

ホストされるアプリケーションでは、GetRawInputDevices によって返される未加工の入力デバイス (ヒューマン インターフェイス デバイス) のセットを登録することで、未加工の入力メッセージを受信します。

関連項目