hozugawa.net · A neutral informational page

GetMessageとPeekMessageでメッセージキューからメッセージを取得する

Windows GUIプログラムでは、マウスやキーボード、再描画、終了要求などの通知がメッセージとしてスレッドのメッセージキューに入ります。ウィンドウプロシージャへ処理を渡すには、まずメッセージループでキューからメッセージを取り出し、必要に応じて変換して配送します。

代表的な取得関数が GetMessage と PeekMessage です。前者は処理対象が現れるまで待機する方式、後者は待機せず現在のキューを確認する方式です。両者の戻り値、削除フラグ、終了処理の違いを理解すると、通常のウィンドウアプリケーションからゲームやタイマー処理まで適切に設計できます。

項目 GetMessage PeekMessage
メッセージがない場合 到着まで待機 すぐに戻る
主な用途 標準的なGUIメッセージループ 描画や更新を続けるループ
キューからの削除 通常は取得時に削除 PM_REMOVE 指定時に削除
WM_QUIT の扱い 戻り値が0 メッセージを取得して戻り値は通常TRUE
CPU使用率 待機中は低い 連続呼び出しでは高くなりやすい

メッセージキューとスレッドの関係

メッセージキューはプロセス全体ではなく、基本的にGUI処理を担当するスレッドに関連付けられます。ウィンドウを作成したスレッドが、そのウィンドウへ届く入力通知やシステム通知を処理する設計が一般的です。別スレッドから直接ウィンドウ状態を操作するより、PostMessage や PostThreadMessage で処理を依頼するほうが安全です。

キューに入るメッセージには、マウス入力やキーボード入力のようにシステムが生成するものと、アプリケーションが PostMessage で送るものがあります。一方、SendMessage は受信側のウィンドウプロシージャを同期的に呼び出すため、メッセージキューから取得する処理とは性質が異なります。

ウィンドウを登録し、拡張スタイルや作成パラメーターを指定する流れは、CreateWindowExの拡張スタイルを確認すると、メッセージループとの関係も把握しやすくなります。

GetMessageの待機型ループ

標準的なGUIアプリケーションでは、次のようなループを使います。

MSG msg;
BOOL result;

while ((result = GetMessage(&msg, nullptr, 0, 0)) > 0) {
    TranslateMessage(&msg);
    DispatchMessage(&msg);
}

GetMessage は対象範囲に一致するメッセージがキューに存在しなければ、メッセージが届くまでスレッドを待機させます。そのため、入力がない時間にループが空回りせず、CPU資源を効率よく利用できます。取得したメッセージは通常、キューから削除されます。

TranslateMessage は仮想キー入力を文字入力メッセージへ変換するために使われ、DispatchMessage は対象ウィンドウのウィンドウプロシージャへ処理を配送します。すべてのメッセージで文字変換が必要とは限りませんが、標準的なキーボード入力を扱うループではこの組み合わせが基本になります。

GetMessage の戻り値は、正の値なら通常のメッセージ取得、0なら WM_QUIT、負の値ならエラーを示します。単純に while (GetMessage(...)) と書く例もありますが、エラーと終了を区別する必要があるコードでは、戻り値を変数へ保存して判定するほうが明確です。

PeekMessageで処理を止めない

PeekMessage はメッセージがなくても直ちに戻るため、描画、物理計算、ファイル監視などを同じスレッドで継続したい場合に向いています。

MSG msg;
bool running = true;

while (running) {
    while (PeekMessage(&msg, nullptr, 0, 0, PM_REMOVE)) {
        if (msg.message == WM_QUIT) {
            running = false;
            break;
        }
        TranslateMessage(&msg);
        DispatchMessage(&msg);
    }

    if (running) {
        UpdateScene();
        RenderScene();
    }
}

PM_REMOVE を指定すると、取得したメッセージをキューから削除します。PM_NOREMOVE なら内容を確認するだけで、同じメッセージが次の呼び出しでも残ります。削除しないまま処理を繰り返すと、同じ通知を何度も検出するため、確認用途以外ではフラグの選択に注意が必要です。

この方式では、メッセージがないときも外側のループが動作します。処理量が少ない場合はCPU使用率が高くなるため、一定時間の待機、タイマー、垂直同期などを組み合わせます。入力処理を優先しつつ更新間隔を制御するには、キューを一度だけ確認するか、一定数まで処理してから描画へ移る設計も有効です。

戻り値と終了メッセージの扱い

WM_QUIT は通常のウィンドウメッセージとは異なり、特定のウィンドウへ配送されるものではありません。PostQuitMessage によってスレッドのメッセージキューへ通知され、GetMessage では戻り値0として示されます。PeekMessage ではメッセージを取得してから、msg.message == WM_QUIT を明示的に確認します。

ウィンドウプロシージャで WM_DESTROY を受け取ったときに PostQuitMessage(0) を呼ぶのが一般的です。終了処理では、メッセージループを抜けた後にリソースを解放し、ウィンドウクラスや描画環境を適切に破棄します。スレッドを強制終了する TerminateThreadの危険性も考慮し、終了通知と協調的な停止を優先してください。

取得関数のエラーを見落とすと、ウィンドウが突然応答しなくなった際の原因を追跡しにくくなります。GetMessage が負の値を返した場合は、必要に応じて GetLastError を使って異常を記録し、通常終了と同じ経路へ流さないようにします。

実装時に確認するポイント

メッセージループを組み込む際は、待機を許容できるアプリケーションか、更新処理を止められないアプリケーションかを最初に判断します。一般的な入力フォームや設定画面なら GetMessage が扱いやすく、連続描画を行うアプリケーションなら PeekMessage と時間管理を組み合わせます。

使い分けの基準

動作確認で見る項目

マウス入力を扱う場合は、メッセージ取得だけでなく、カーソル位置の制限や座標変換も確認します。たとえば、カーソル移動範囲を制限する処理を追加しても、入力通知自体は同じメッセージループを通過します。取得、配送、ウィンドウプロシージャ内の状態更新を分けて検証すると、問題の位置を特定しやすくなります。

まずは GetMessage を使った最小のウィンドウを作成し、WM_QUIT で確実にループを抜けることを確認したうえで、必要な場合だけ PeekMessage と更新処理へ置き換えてください。