LowLevelMouseProc 関数

[アーティクル]
07/01/2023

説明

SetWindowsHookExA SetWindowsHookExW関数で使用されるアプリケーション定義またはライブラリ定義のコールバック関数。/ システムは、新しいマウス入力イベントがスレッド入力キューにポストされようとするたびに、この関数を呼び出します。

HOOKPROC 型は、このコールバック関数へのポインターを定義します。 LowLevelMouseProc は、アプリケーション定義またはライブラリ定義関数名のプレースホルダーです。

LowLevelMouseProc は、アプリケーション定義またはライブラリ定義関数名のプレースホルダーです。

LRESULT CALLBACK LowLevelMouseProc(
  _In_ int    nCode,
  _In_ WPARAM wParam,
  _In_ LPARAM lParam
);

パラメーター

nCode [in]

型: int

フックプロシージャがメッセージの処理方法を決定するために使用するコード。

nCode が 0 未満の場合、フックプロシージャは、それ以上の処理を行わずに CallNextHookEx 関数にメッセージを渡す必要があり、CallNextHookEx によって返される値を返す必要があります。

このパラメーターには、次の値のいずれかを指定できます。

値	説明
HC_ACTION 0	wParam パラメーターと lParam パラメーターには、マウスメッセージに関する情報が含まれています。

wParam [in]

型: WPARAM

マウスメッセージの識別子。

このパラメーターには、WM_LBUTTONDOWN、WM_LBUTTONUP、WM_MOUSEMOVE、WM_MOUSEWHEEL、WM_RBUTTONDOWN 、または WM_RBUTTONUPのいずれかのメッセージを指定できます。

lParam [in]

型: LPARAM

MSLLHOOKSTRUCT 構造体へのポインター。

戻り値

型: LRESULT

nCode が 0 未満の場合、フックプロシージャは CallNextHookEx によって返される値を返す必要があります。

nCode が 0 以上で、フックプロシージャがメッセージを処理しなかった場合は、CallNextHookEx を呼び出し、返される値を返すよう強くお勧めします。それ以外の場合、WH_MOUSE_LLフックがインストールされている他のアプリケーションはフック通知を受け取らず、結果として正しく動作しない可能性があります。

フックプロシージャがメッセージを処理した場合、システムがフックチェーンまたはターゲットウィンドウプロシージャの残りの部分にメッセージを渡さないようにするために、0 以外の値を返す可能性があります。

注釈

アプリケーションは、setWindowsHookExA/SetWindowsHookExW 関数の呼び出しで、WH_MOUSE_LLフックの種類とフックプロシージャへのポインターを指定して、フックプロシージャをインストールします。

このフックは、インストールしたスレッドのコンテキストで呼び出されます。呼び出しは、フックをインストールしたスレッドにメッセージを送信することによって行われます。したがって、フックをインストールしたスレッドにはメッセージループが必要です。

マウス入力は、ローカルマウスドライバーまたは mouse_event 関数の呼び出しから取得できます。入力が mouse_event の呼び出しから送信された場合、入力は "挿入" されました。ただし、 WH_MOUSE_LL フックは別のプロセスに挿入されません。代わりに、コンテキストはフックをインストールしたプロセスに戻り、元のコンテキストで呼び出されます。その後、コンテキストは、イベントを生成したアプリケーションに戻ります。

フックプロシージャは、次のレジストリキーの LowLevelHooksTimeout 値で指定されたデータエントリよりも短い時間でメッセージを処理する必要があります。

HKEY_CURRENT_USER\Control Panel\Desktop

値の単位はミリ秒です。フック・プロシージャーがタイムアウトした場合、システムはメッセージを次のフックに渡します。ただし、Windows 7 以降では、フックは呼び出されることなく自動的に削除されます。フックが削除されたかどうかをアプリケーションが認識する方法はありません。

バージョン 1709 以降Windows 10システムで許容される最大タイムアウト値は 1000 ミリ秒 (1 秒) です。 LowLevelHooksTimeout 値が 1000 より大きい値に設定されている場合、システムは既定で 1000 ミリ秒のタイムアウトを使用します。

注意

デバッグフックでは、この種類の低レベルのマウスフックを追跡できません。アプリケーションで低レベルのフックを使用する必要がある場合は、作業をワーカースレッドに渡してすぐに戻る専用スレッドでフックを実行する必要があります。アプリケーションで低レベルのフックを使用する必要があるほとんどの場合は、代わりに生の入力を監視する必要があります。これは、生の入力では、低レベルのフックよりも効果的に、他のスレッドを対象とするマウスメッセージとキーボードメッセージを非同期的に監視できるためです。生入力の詳細については、「生入力」を参照してください。

次の方法で共有

LowLevelMouseProc 関数

説明

パラメーター

nCode [in]

wParam [in]

lParam [in]

戻り値

注釈

関連項目

フィードバック

フィードバック

その他のリソース