GetMessage 함수(winuser.h)
호출 스레드의 메시지 큐에서 메시지를 검색합니다. 함수는 게시된 메시지를 검색할 수 있게 될 때까지 들어오는 보낸 메시지를 디스패치합니다.
그러나 GetMessage 와 같은 GetMessage 함수는 반환하기 전에 메시지가 게시될 때까지 GetMessage 가 차단됩니다.
구문
BOOL GetMessage(
[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)을 지정하여 첫 번째 마우스 메시지를 지정합니다.
wMsgFilterMax의 WM_INPUT 사용하여 WM_INPUT 메시지만 지정합니다.
wMsgFilterMin 및 wMsgFilterMax가 모두 0이면 GetMessage는 사용 가능한 모든 메시지를 반환합니다(즉, 범위 필터링이 수행되지 않음).
[in] wMsgFilterMax
형식: UINT
검색할 가장 높은 메시지 값의 정수 값입니다. WM_KEYLAST 사용하여 마지막 키보드 메시지를 지정하거나 WM_MOUSELAST 마지막 마우스 메시지를 지정합니다.
wMsgFilterMin의 WM_INPUT 사용하여 WM_INPUT 메시지만 지정합니다.
wMsgFilterMin 및 wMsgFilterMax가 모두 0이면 GetMessage는 사용 가능한 모든 메시지를 반환합니다(즉, 범위 필터링이 수행되지 않음).
반환 값
형식: 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
GetMessage 는 큐에서 WM_PAINT 메시지를 제거하지 않습니다. 메시지는 처리될 때까지 큐에 남아 있습니다.
최상위 창이 몇 초 이상 메시지에 응답하지 않는 경우 시스템은 창이 응답하지 않는 것으로 간주하고 z 순서, 위치, 크기 및 시각적 특성이 동일한 고스트 창으로 바꿉니다. 이렇게 하면 사용자가 이동하거나 크기를 조정하거나 애플리케이션을 닫을 수 있습니다. 그러나 이러한 작업은 애플리케이션이 실제로 응답하지 않기 때문에 사용할 수 있는 유일한 작업입니다. 디버거 모드에서 시스템에서 고스트 창을 생성하지 않습니다.
DPI 가상화
이 API는 DPI 가상화에 참여하지 않습니다. 출력은 메시지가 대상으로 하는 창의 모드에 있습니다. 호출 스레드는 고려되지 않습니다.예제
예를 들어 메시지 루프 만들기를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | winuser.h(Windows.h 포함) |
| 라이브러리 | User32.lib |
| DLL | User32.dll |
| API 세트 | ext-ms-win-ntuser-message-l1-1-0(Windows 8 도입) |
추가 정보
개념
참조