GetMessageW 関数 (winuser.h)

[アーティクル]
03/09/2024

呼び出し元のスレッドのメッセージキューからメッセージを取得します。関数は、送信されたメッセージが取得可能になるまで、受信したメッセージをディスパッチします。

GetMessage とは異なり、PeekMessage 関数は、メッセージが投稿されるのを待ってからを返しません。

構文

BOOL GetMessageW(
  [out]          LPMSG lpMsg,
  [in, optional] HWND  hWnd,
  [in]           UINT  wMsgFilterMin,
  [in]           UINT  wMsgFilterMax
);

パラメーター

[out] lpMsg

種類: LPMSG

スレッドのメッセージキューからメッセージ情報を受信する MSG 構造体へのポインター。

[in, optional] hWnd

型: HWND

メッセージを取得するウィンドウのハンドル。ウィンドウは現在のスレッドに属している必要があります。

hWnd が NULL の場合、GetMessage は、現在のスレッドに属するすべてのウィンドウのメッセージと、hwnd 値が NULL である現在のスレッドのメッセージキュー上のすべてのメッセージを取得します (MSG 構造体を参照)。したがって、hWnd が NULL の場合、ウィンドウメッセージとスレッドメッセージの両方が処理されます。

hWnd が -1 の場合、GetMessage は、現在のスレッドのメッセージキューのメッセージのみを取得します。その hwnd 値が NULL です。つまり、PostMessage によって投稿されたスレッドメッセージ (hWnd パラメーターが NULL の場合) または PostThreadMessage。

[in] wMsgFilterMin

型: UINT

取得するメッセージの最小値の整数値。 WM_KEYFIRST (0x0100) を使用して、最初のキーボードメッセージを指定するか、WM_MOUSEFIRST (0x0200) を使用して最初のマウスメッセージを指定します。

WM_INPUT メッセージのみを指定するには、ここでと wMsgFilterMax のWM_INPUTを使用します。

wMsgFilterMin と wMsgFilterMax の両方が 0 の場合、GetMessage は使用可能なすべてのメッセージを返します (つまり、範囲フィルター処理は実行されません)。

[in] wMsgFilterMax

型: UINT

取得するメッセージの最大値の整数値。 WM_KEYLASTを使用して、最後のキーボードメッセージを指定するか、最後のマウスメッセージを指定するWM_MOUSELASTを使用します。

WM_INPUT メッセージのみを指定するには、ここでと wMsgFilterMin のWM_INPUTを使用します。

戻り値

種類: BOOL

関数が WM_QUIT 以外のメッセージを取得する場合、戻り値は 0 以外です。

関数が WM_QUIT メッセージを取得する場合、戻り値は 0 です。

エラーが発生した場合、戻り値は -1 です。たとえば、 hWnd が無効なウィンドウハンドルであるか、 lpMsg が無効なポインターである場合、関数は失敗します。詳細なエラー情報を得るには、GetLastError を呼び出します。

戻り値には 0 以外、0、または -1 を指定できるため、次のようなコードは使用しないでください。

while (GetMessage( lpMsg, hWnd, 0, 0)) ...

hWnd が無効なパラメーターである場合に -1 の戻り値が返される可能性 (既に破棄されているウィンドウを参照するなど) は、このようなコードが致命的なアプリケーションエラーにつながる可能性があることを意味します。代わりに、次のようなコードを使用します。

BOOL bRet;

while( (bRet = GetMessage( &msg, hWnd, 0, 0 )) != 0)
{ 
    if (bRet == -1)
    {
        // handle the error and possibly exit
    }
    else
    {
        TranslateMessage(&msg); 
        DispatchMessage(&msg); 
    }
}

注釈

通常、アプリケーションは戻り値を使用して、メインメッセージ・ループを終了してプログラムを終了するかどうかを判別します。

GetMessage 関数は、hWnd パラメーターまたはその子で識別されるウィンドウに関連付けられたメッセージを、IsChild 関数で指定され、wMsgFilterMin パラメーターと wMsgFilterMax パラメーターによって指定されたメッセージ値の範囲内で取得します。アプリケーションでは、 wMsgFilterMin パラメーターと wMsgFilterMax パラメーター内のローワードのみを使用できることに注意してください。高い単語はシステム用に予約されています。

GetMessage は、wMsgFilterMin と wMsgFilterMax に指定した値に関係なく、常にWM_QUITメッセージを取得します。

この呼び出し中に、システムは保留中のキューに入れないメッセージ、つまり SendMessage、SendMessageCallback、SendMessageTimeout、または SendNotifyMessage 関数を使用して、呼び出し元のスレッドが所有するウィンドウに送信されたメッセージを配信します。その後、指定したフィルターに一致するキューに入った最初のメッセージが取得されます。システムは内部イベントを処理することもできます。フィルターが指定されていない場合、メッセージは次の順序で処理されます。

送信されたメッセージ
投稿されたメッセージ
入力 (ハードウェア) メッセージとシステム内部イベント
送信されたメッセージ (もう一度)
メッセージのWM_PAINT
メッセージのWM_TIMER

投稿されたメッセージの前に入力メッセージを取得するには、 wMsgFilterMin パラメーターと wMsgFilterMax パラメーターを 使用します。

GetMessage では、キューからWM_PAINT メッセージは削除されません。メッセージは処理されるまでキューに残ります。

最上位のウィンドウが数秒間以上メッセージへの応答を停止した場合、システムはウィンドウが応答していないと見なし、同じ z オーダー、場所、サイズ、およびビジュアル属性を持つゴーストウィンドウに置き換えます。これにより、ユーザーはそれを移動したり、サイズを変更したり、アプリケーションを閉じることもできます。ただし、アプリケーションが実際には応答しないため、これらは唯一のアクションとして使用できます。デバッガーモードの場合、システムはゴーストウィンドウを生成しません。

DPI 仮想化

この API は、DPI 仮想化には参加しません。出力は、メッセージがターゲットとしているウィンドウのモードです。呼び出し元のスレッドは考慮されません。

例

例については、「メッセージループの作成」を参照してください。

注意

winuser.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして GetMessage を定義します。エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	winuser.h (Windows.h を含む)
Library	User32.lib
[DLL]	User32.dll
API セット	ext-ms-win-ntuser-message-l1-1-0 (Windows 8 で導入)

GetMessageW 関数 (winuser.h)

構文

パラメーター

戻り値

注釈

DPI 仮想化

例

要件

関連項目

フィードバック

フィードバック

その他のリソース