KeyboardProc コールバック関数

説明

SetWindowsHookExA/SetWindowsHookExW 関数で使用されるアプリケーション定義またはライブラリ定義のコールバック関数。

アプリケーションが GetMessage または PeekMessageA/PeekMessageW 関数を呼び出し、処理するキーボード メッセージ (WM_KEYUPまたはWM_KEYDOWNがある場合は常に、この関数を呼び出します。

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

LRESULT CALLBACK KeyboardProc(
  _In_ int    code,
  _In_ WPARAM wParam,
  _In_ LPARAM lParam
);

パラメーター

code [in]

型: int

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

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

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

wParam [in]

型: WPARAM

キーストローク メッセージを生成したキーの 仮想キー コード 。

lParam [in]

型: LPARAM

繰り返し数、スキャン コード、拡張キー フラグ、コンテキスト コード、前のキー状態フラグ、および遷移状態フラグ。 lParam パラメーターの詳細については、「キーストローク メッセージ フラグ」を参照してください。 次の表では、この値のビットについて説明します。

戻り値

型: LRESULT

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

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

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

注釈

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

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

関連項目

• CallNextHookEx
• GetMessage
• PeekMessage
• SetWindowsHookEx
• WM_KEYUP
• WM_KEYDOWN
• フック
• キーボード入力 (キーボードとマウス入力)
• キーボード入力の概要