他のウィンドウのメッセージを取得する

最終更新 2004 02/19

サンプルのダウンロード → API_SetWindowsHookEx.lzh(128k)

【 サンプルソースの使い方 】

このサンプルを実行するには

１．「フックをしかけるウィンドウのプロジェクト」
２．「フックしたメッセージを受け取るウィンドウのプロジェクト」
３．「フックを実行するためのＤＬＬのプロジェクト」

以上の３つのプロジェクトを作成する必要があります。

１．と２．は「Win32 Application」でプロジェクトを作成しますが
３．は「Win32 Dynamic-Link Library」で作成することに注意して下さい。

プロジェクト名はなんでも構いませんが、サンプルと同じ名前に
しておく方が無難だと思います。

プロジェクトを作成したら、それぞれ main.cpp というソースファイルを
新規で作成してプロジェクトに追加します。
main.cpp を作成したら、それぞれのプロジェクトのソースをコピーして
ビルドします。


【 ビルドと実行手順 】

まず最初に３．のＤＬＬを作成してビルドします。
ビルドしてできたＤＬＬを２．のプロジェクトの main.cpp と同じフォルダに
コピーします。
念のため、２．の実行ファイルと同じフォルダにもコピーしておくと良いです。
１．と２．はどちらを先にビルドしても構いません。

実行するときは、１．の実行ファイルを先に起動します。
その後、２．の実行ファイルを起動します。


【 補足 】

１．のウィンドウはフックをしかけたいだけのウィンドウなので、ウィンドウを
表示する以外は特に何も処理を行いません。
サンプルでは分かりやすいように説明文を表示しているだけです。
なので、１．のウィンドウはクラス名かウィンドウのタイトルバーの文字さえ
分かってしまえば、どんなアプリケーションでも構いません。

面倒なら１．のサンプルは使わなくても動かすことはできます。
ただ、１．のサンプルを使わない場合は、２．のサンプルの上の方で #define を
している TARGET_CLASS と TARGET_TITLE の値を、フックしたいアプリケーションの
クラス名とタイトルバーに表示される文字に書き換える必要があります。

１．「フックをしかけるウィンドウのプロジェクト」の main.cpp
　　（ プロジェクト名：API_SetWindowsHookEx1 ）
//インクルード #include <windows.h> //クラス名定義 #define CLASS_NAME "Hook Target Window" //クラス名 #define WINDOW_TITLE "フック対象ウィンドウ" //ウィンドウのタイトルバーに表示する文字 #define WINDOW_WIDTH 400 //ウィンドウの横幅 #define WINDOW_HEIGHT 300 //ウィンドウの高さ //プロトタイプ宣言 LRESULT CALLBACK WinProc( HWND, UINT, WPARAM, LPARAM ); //メイン int WINAPI WinMain( HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int nShowCmd ) { { //ウィンドウクラス設定＆登録 WNDCLASS wc; wc.cbClsExtra = 0; wc.cbWndExtra = 0; wc.hbrBackground = (HBRUSH)GetStockObject( WHITE_BRUSH ); wc.hCursor = LoadCursor( NULL, IDC_ARROW ); wc.hIcon = LoadIcon( NULL, IDI_WINLOGO ); wc.hInstance = hInstance; wc.lpfnWndProc = WinProc; wc.lpszClassName = CLASS_NAME; wc.lpszMenuName = NULL; wc.style = 0; if( !RegisterClass( &wc ) ) return 1; } //ウィンドウ作成 HWND hWnd = CreateWindow( CLASS_NAME, WINDOW_TITLE, WS_CAPTION | WS_SYSMENU | WS_VISIBLE, CW_USEDEFAULT, CW_USEDEFAULT, WINDOW_WIDTH, WINDOW_HEIGHT, NULL, NULL, hInstance, NULL ); if( hWnd == NULL ) return 1; //メッセージループ while( true ) { MSG msg; if( GetMessage( &msg, NULL, 0, 0 ) <= 0 ) break; TranslateMessage( &msg ); DispatchMessage( &msg ); } return 0; } //メッセージの対応 LRESULT CALLBACK WinProc( HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam ) { switch( uMsg ) { case WM_DESTROY: PostQuitMessage(0); break; case WM_PAINT: { PAINTSTRUCT ps; BeginPaint( hWnd, &ps ); char text[256]; wsprintf( text, "このウィンドウの上でキーやマウスボタンを" ); TextOut( ps.hdc, 10, 10, text, lstrlen(text) ); wsprintf( text, "押すと、「フック実行ウィンドウ」に押された" ); TextOut( ps.hdc, 10, 30, text, lstrlen(text) ); wsprintf( text, "キーのキーコードやボタンが表示されます。" ); TextOut( ps.hdc, 10, 50, text, lstrlen(text) ); EndPaint( hWnd, &ps ); break; } } return DefWindowProc( hWnd, uMsg, wParam, lParam ); }

２．「フックしたメッセージを受け取るウィンドウのプロジェクト」の main.cpp
　　（ プロジェクト名：API_SetWindowsHookEx2 ）
//インクルード #include <windows.h> //クラス名定義 #define CLASS_NAME "API_SetWindowsHookEx Sample" //クラス名 #define WINDOW_TITLE "フック実行ウィンドウ" //ウィンドウのタイトルバーに表示する文字 #define WINDOW_WIDTH 300 //ウィンドウの横幅 #define WINDOW_HEIGHT 100 //ウィンドウの高さ #define DLL_NAME "API_SetWindowsHookEx_DLL.dll" //フックに使うＤＬＬ名 #define TARGET_CLASS "Hook Target Window" //フックするウィンドウのクラス名 #define TARGET_TITLE "フック対象ウィンドウ" //フックするウィンドウのタイトルバーの文字 //プロトタイプ宣言 LRESULT CALLBACK WinProc( HWND, UINT, WPARAM, LPARAM ); //メイン int WINAPI WinMain( HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int nShowCmd ) { { //ウィンドウクラス設定＆登録 WNDCLASS wc; wc.cbClsExtra = 0; wc.cbWndExtra = 0; wc.hbrBackground = (HBRUSH)GetStockObject( WHITE_BRUSH ); wc.hCursor = LoadCursor( NULL, IDC_ARROW ); wc.hIcon = LoadIcon( NULL, IDI_WINLOGO ); wc.hInstance = hInstance; wc.lpfnWndProc = WinProc; wc.lpszClassName = CLASS_NAME; wc.lpszMenuName = NULL; wc.style = CS_GLOBALCLASS; if( !RegisterClass( &wc ) ) return 1; } //ウィンドウ作成 HWND hWnd = CreateWindow( CLASS_NAME, WINDOW_TITLE, WS_CAPTION | WS_SYSMENU | WS_VISIBLE, CW_USEDEFAULT, CW_USEDEFAULT, WINDOW_WIDTH, WINDOW_HEIGHT, NULL, NULL, hInstance, NULL ); if( hWnd == NULL ) return 1; //メッセージをフックするウィンドウを探す HWND hwnd_target = FindWindow( TARGET_CLASS, TARGET_TITLE ); if( hwnd_target == NULL ) return 1; //メッセージをフックするウィンドウのスレッドＩＤを取得 DWORD thread_id = GetWindowThreadProcessId( hwnd_target, NULL ); //ＤＬＬ呼び出し HINSTANCE hinst_dll = LoadLibrary( DLL_NAME ); if( hinst_dll == NULL ) return 1; //ＤＬＬの SetHook() 関数を呼ぶ { typedef bool ( SETHOOK )( HWND, DWORD ); SETHOOK* pSetHook = (SETHOOK*)GetProcAddress( hinst_dll, "SetHook" ); if( pSetHook == NULL ){ FreeLibrary( hinst_dll ); return 1; } if( !pSetHook( hWnd, thread_id ) ){ FreeLibrary( hinst_dll ); return 1; } } //メッセージループ while( true ) { MSG msg; if( GetMessage( &msg, NULL, 0, 0 ) <= 0 ) break; TranslateMessage( &msg ); DispatchMessage( &msg ); } //ＤＬＬの ResetHook() 関数を呼ぶ { typedef bool ( RESETHOOK )(); RESETHOOK* pResetHook = (RESETHOOK*)GetProcAddress( hinst_dll, "ResetHook" ); if( pResetHook != NULL ) pResetHook(); } //呼び出したＤＬＬを解放 FreeLibrary( hinst_dll ); return 0; } //メッセージの対応 LRESULT CALLBACK WinProc( HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam ) { static short key_code = 0; static UINT timer_id = 0; static POINT mouse_pos = { 0, 0 }; static int click = 0; // 0 = 左クリック 1 = 右クリック 2 = 真中クリック switch( uMsg ) { case WM_CREATE: timer_id = SetTimer( hWnd, 1, 100, NULL ); if( timer_id == 0 ) PostQuitMessage(0); break; case WM_DESTROY: if( timer_id != 0 ) KillTimer( hWnd, timer_id ); PostQuitMessage(0); break; case WM_LBUTTONDOWN: click = 0; break; case WM_RBUTTONDOWN: click = 1; break; case WM_MBUTTONDOWN: click = 2; break; case WM_MOUSEMOVE: mouse_pos.x = LOWORD( lParam ); mouse_pos.y = HIWORD( lParam ); break; case WM_KEYDOWN: key_code = wParam; break; case WM_TIMER: InvalidateRect( hWnd, NULL, TRUE ); break; case WM_PAINT: { PAINTSTRUCT ps; BeginPaint( hWnd, &ps ); BitBlt( ps.hdc, 0, 0, WINDOW_WIDTH, WINDOW_HEIGHT, NULL, 0, 0, WHITENESS ); SetBkMode( ps.hdc, TRANSPARENT ); SetTextColor( ps.hdc, RGB(0,0,0) ); char text[256]; wsprintf( text, "押されたキー：%d", key_code ); TextOut( ps.hdc, 10, 10, text, lstrlen(text) ); switch( click ) { case 0: wsprintf( text, "押されたマウスボタン：左" ); break; case 1: wsprintf( text, "押されたマウスボタン：右" ); break; case 2: wsprintf( text, "押されたマウスボタン：中央" ); break; default: memset( text, '\0', sizeof(text) ); break; } TextOut( ps.hdc, 10, 30, text, lstrlen(text) ); wsprintf( text, "マウスカーソルの位置 x:%03d y:%03d", mouse_pos.x, mouse_pos.y ); TextOut( ps.hdc, 10, 50, text, lstrlen(text) ); EndPaint( hWnd, &ps ); break; } } return DefWindowProc( hWnd, uMsg, wParam, lParam ); }

３．「フックを実行するためのＤＬＬのプロジェクト」の main.cpp
　　（ プロジェクト名：API_SetWindowsHookEx_DLL ）
#include <windows.h> //共有データ #pragma data_seg( ".sharedata" ) HINSTANCE g_hInstance = NULL; //このＤＬＬのインスタンスハンドル HHOOK g_hHook = NULL; //フックハンドル HWND g_hWnd = NULL; //フックしたメッセージを送信するウィンドウのハンドル #pragma data_seg() //共有データの設定を適用 //こうすると def ファイルを作って設定しなくてもいい //SECTIONS に .sharedata を設定 RWS = READ WRITE SHARED の意味 //#pragma を使わずに def ファイルを作る場合、def ファイルに // //SECTIONS // .sharedata READ WRITE SHARED // //と書く //作った def ファイルはプロジェクトに登録する #pragma comment( linker, "/SECTION:.sharedata,RWS" ) //関数のオーバーロードはなし（関数をＣスタイルでコンパイル） #ifdef __cplusplus extern "C"{ #endif //プロトタイプ宣言 __declspec( dllexport ) bool SetHook( HWND, DWORD ); __declspec( dllexport ) bool ResetHook(); #ifdef __cplusplus } #endif //メイン BOOL APIENTRY DllMain( HINSTANCE hinstDLL, DWORD fdwReason, LPVOID lpvReserved ) { switch( fdwReason ) { case DLL_PROCESS_ATTACH: case DLL_THREAD_ATTACH: //インスタンスハンドルを保存 g_hInstance = (HINSTANCE)hinstDLL; break; } return TRUE; } //フックプロシージャ LRESULT CALLBACK HookProc( int nCode, WPARAM wParam, LPARAM lParam ) { if( nCode == HC_ACTION ) { MSG* p_msg = (MSG*)lParam; switch( p_msg->message ) { case WM_KEYDOWN: case WM_MOUSEMOVE: case WM_LBUTTONDOWN: case WM_RBUTTONDOWN: case WM_MBUTTONDOWN: //フックしたメッセージを g_hWnd のウィンドウへ送信する //SendMessage() でないのは、メッセージの処理待ちをしたくないから //HookProc() 内では時間のかかる処理を行ってはいけないため //PostMessage() でメッセージを送信したら直ちに復帰してもらう PostMessage( g_hWnd, p_msg->message, p_msg->wParam, p_msg->lParam ); break; } } return CallNextHookEx( g_hHook, nCode, wParam, lParam ); } //フック開始 bool SetHook( HWND hWnd, DWORD threadId ) { //フックしたメッセージを送信するウィンドウのハンドルを保存 g_hWnd = hWnd; //メッセージフック開始 g_hHook = SetWindowsHookEx( WH_GETMESSAGE, HookProc, g_hInstance, threadId ); if( g_hHook != NULL && g_hWnd != NULL ) return true; else return false; } //フック解除 bool ResetHook() { if( UnhookWindowsHookEx( g_hHook ) != 0 ) return true; else return false; }

SetWindowsHookEx 関数
UnhookWindowsHookEx 関数
CallNextHookEx 関数

    対応しているバージョン
    95, 98, Me, NT3.1以降, 2000, XP

    使用するヘッダとライブラリ
    winuser.h
    user32.lib



【 メッセージフック？ 】


VC++ についてくる Spy++ や、スクリーンセーバー、またはキーボードに入力した
文字の記録を取るソフトなどを作るには、メッセージフックというものを使います。
ゲームの支援ツールなどでもよく使われます。(ゲーム中の特定のコマンドをマウス
の右クリックに割り当てるなどのツール)

メッセージフックとは、ウィンドウにメッセージが送られて来た時に、釣り針の
ようなものでメッセージをひっかけて取ってしまうという意味から、こう呼ばれる
そうです。

メッセージフックにはローカルフックとグローバル（システム）フックの２種類が
あり、ローカルフックは自分のウィンドウのメッセージをフックすることで
グローバルフックは、ウィンドウズ全体、あるいは自分以外のウィンドウの
メッセージをフックすることを言います。

ローカルフックはまず使わないと思います。
自分のウィンドウのメッセージはいくらでもウィンドウプロシージャで取って
これますから・・・。

ここではグローバルフックの使い方のみ説明します。



【 メッセージフックに使うＡＰＩ関数 】


メッセージフックを仕掛けるには、SetWindowsHookEx() 関数を使います。
仕掛けたフックを解除するには UnhookWindowsHookEx() 関数を使います。
仕掛けたフックはプログラムを終了する前にかならず解除しなければいけません。



【 SetWindowsHookEx() 関数について 】


グローバルフックを仕掛けるには次のように呼び出します。

HHOOK hHook = SetWindowsHookEx(
                フックするメッセージの種類,
                フックしたメッセージを処理する関数のポインタ,
                ＤＬＬのインスタンスハンドル,
                フックを仕掛けるウィンドウのスレッドＩＤ
                );


最初の引数 フックするメッセージの種類 には、フックしたメッセージを
どう処理するかの値を指定します。（指定できる値は MSDN ライブラリ参照）
フックしたメッセージを取得して、メッセージの内容を変更したいときには
WH_GETMESSAGE を指定します。


２番目の引数 フックしたメッセージを処理する関数のポインタ は、そのままの
意味です。

サンプルのように


LRESULT CALLBACK HookProc( int nCode, WPARAM wParam, LPARAM lParam )


のように宣言して、この関数名を指定します。
この関数内ではフックしたメッセージの処理を行います。

関数名の HookProc は自分の好きな名前にしても構いません。
MyMsgProc という関数名にした場合は、２番目の引数に MyMsgProc と指定すれば
よいことになります。


３番目の引数 ＤＬＬのインスタンスハンドル には、ＤＬＬのメイン関数に
渡ってくるインスタンスハンドルをそのまま指定します。


４番目の引数 フックを仕掛けるウィンドウのスレッドＩＤ には、フックを
仕掛けたいウィンドウのスレッドＩＤを指定します。
ウィンドウズ全体のメッセージをフックしたい場合は 0 を指定します。

フックを仕掛けたいウィンドウのスレッドＩＤを取得するには
次のようにします。


//hWnd にフックを仕掛けたいウィンドウの
//ウィンドウハンドルを格納しておく

DWORD threadId = GetWindowThreadProcessId( hWnd, NULL );


スレッドＩＤが何か？については、長くなるのでここでは説明しません。
ここではどうやって取って来るかが分かれば問題はないです。



【 グローバルフックのコツ 】


グローバルフックを行う上で重要な点は

１．フックの処理はＤＬＬ側で行う
２．フックの処理に使う変数は共有メモリに配置する
３．ＤＬＬから呼び出す関数には extern "C" をつける
４．フックしたメッセージは呼び出し元にそのまま送信する

以上の４点です。

いちいちＤＬＬを作らなければならないのが少々めんどうですが、ＤＬＬで
処理を行わないと動いてくれません。


まず、１．「フックの処理はＤＬＬ側で行う」ですが、フックを仕掛ける処理や
解除する処理、フックを仕掛けたウィンドウから取ってきたメッセージを処理する
関数など、全てＤＬＬ側で処理を行います。


次に２．「フックの処理に使う変数は共有メモリに配置する」ですが、ＤＬＬの
インスタンスハンドル、フックハンドル、フックしたメッセージを送信するウィンドウ
（ＤＬＬの呼び出し元）のハンドルは共有メモリに配置します。

共有メモリ？といわれてもピンと来ませんし、私自身いまのところ、何故
こうするのかがよく分かっていません。
ただ、こうしないと動きません。

共有メモリに配置した変数は、ＤＬＬ側と呼び出し側のアプリケーションの
どちらからも同じアドレスを見れば参照できる・・・というような意味なので
しょうか・・・。
共有というからには、何らかの形でＤＬＬと呼び出し元で連携ができるような
値なんだろうと推測します。


//共有メモリを宣言
#pragma data_seg( ".sharedata" )
HINSTANCE g_hInstance = NULL;
HHOOK     g_hHook     = NULL;
HWND      g_hWnd      = NULL;
#pragma data_seg()

//共有メモリを設定
#pragma comment( linker, "/SECTION:.sharedata,RWS" )


#pragma data_seg( ".名前" ) 〜 #pragma data_seg() で、共有メモリに
配置する変数を宣言します。
共有メモリに配置する変数は必ず初期化しないといけません。

そのあと、#pragma comment( linker, 〜略〜 ) で、共有メモリを設定します。

.sharedata の . 以下は自分の好きな名前に変更可能です。


３．「ＤＬＬから呼び出す関数には extern "C" をつける」については
ＤＬＬから呼び出したい関数に extern "C" を付けないで関数の宣言を行うと
外部からＤＬＬの中にある関数を呼び出すのがかなり面倒になります。
詳しい説明は省略しますが、これを防ぐ為に extern "C" をつけます。

extern "C" というのは、C の規則でコンパイルするという意味です。
C++ の規則でコンパイルされると都合が悪いときに、この修飾子を
つけるときがままあります。
今回もそのようなケースです。

またＤＬＬから呼び出したい関数は、プロトタイプ宣言するときに、頭に
__declspec( dllexport ) と付けないと外部から呼び出すことができません。


//もしコンパイラが C++ 対応なら、以下の部分では関数宣言の頭に
//extern "C" を付けて、C の規則でコンパイルする

#ifdef __cplusplus
extern "C"{
#endif

//プロトタイプ宣言
//ＤＬＬの外部から以下の２つの関数を呼び出すことができる

__declspec( dllexport ) bool SetHook( HWND, DWORD );
__declspec( dllexport ) bool ResetHook();

#ifdef __cplusplus
}
#endif

//ここまで C の規則でコンパイルされます



４．「フックしたメッセージを呼び出し元にそのまま送信する」については
これは必ずしもこうする必要はないのですが、処理が簡単で使いまわしが利く
ＤＬＬを作れるので、このようにしてみては？という提案をしているような
感じです。

サンプルソースの３．では、SetHook() 関数の引数で、フックしたメッセージを
送り返すウィンドウのハンドルと、フックしたいウィンドウのスレッドＩＤを
指定します。

フックしたいウィンドウに送られたメッセージを捕まえると、まず HookProc() が
呼び出されます。
そうしたら、HookProc() 関数の中で使えるメッセージかどうかを判断して、使える
メッセージならフックしたメッセージを送り返すウィンドウに、捕まえたメッセージを
そのまま送信します。

そうするとフックしたメッセージを送り返すウィンドウ、つまり、サンプルソース２．
のウィンドウの WinProc() が呼び出されます。
実際はサンプルソース１．に送信されたメッセージなのに、サンプルソース２．の
ウィンドウに送信されたかのように、そのメッセージを扱うことができます。



【 フックしたいウィンドウを探すには？ 】


ウィンドウズ全体のメッセージをフックする場合はいいのですが、例えばメモ帳を
起動していて、そのメモ帳のメッセージをフックしたい場合、どうやってメモ帳の
ウィンドウハンドルを取得すればいいのでしょうか。

その方法は
「現在起動しているアプリケーションのウィンドウハンドルを取得する」
で説明しているので、そちらをご覧下さい。



【 ＤＬＬの関数を呼び出して使う方法 】


ＤＬＬを読み込んで、ＤＬＬにある関数を実行する方法は ＤＬＬの作成と使い方 で
説明しているので、そちらをご覧下さい。

| home |