GetMessage

GetMessage 함수 호출 스레드의 메시지 큐에서 메시지를 검색 하 고 지정 된 구조에 배치 합니다. 이 함수는 지정된 된 윈도우와 관련 된 메시지를 모두 검색할 수 있습니다 및 스레드 메시지를 통해 게시 PostThreadMessage 함수. 함수는 메시지 값의 지정된 된 범위 내에 있는 메시지를 검색 합니다. GetMessage 다른 스레드 또는 응용 프로그램에 속해 있는 windows에 대 한 메시지를 검색 하지 않습니다.

(BOOL GetMessage LPMSG  lpMsg, / / 주소 메시지 구조HWNDhWnd, / / 창 처리UINTwMsgFilterMin, / / 처음 메시지UINTwMsgFilterMax / / 마지막 메시지);
 

매개 변수

lpMsg
스레드의 메시지 큐에서 메시지 정보를 수신 하는 메시지 구조에 대 한 포인터.
hWnd
메시지는 검색할 창 핸들. 하나의 값에 특별 한 의미를:
의미
NULL GetMessage 호출 스레드에 속하는 모든 창에 대 한 메시지와 PostThreadMessage 를 통해 호출 하는 스레드를 게시 하는 스레드 메시지를 검색 합니다..

wMsgFilterMin
검색할 메시지 최소값의 정수 값을 지정 합니다.
wMsgFilterMax
검색할 메시지 최대값의 정수 값을 지정 합니다.

반환 값

반환 값은 0이 아닌 함수 이외의 WM_QUIT 메시지를 검색 하는 경우.

반환 값 0은 함수 WM_QUIT 메시지를 검색 하는 경우.

오류가 있으면 반환 값은-1입니다. 예를 들어, 함수는 hWnd 는 잘못 된 창 핸들 또는 lpMsg 잘못 된 포인터를 하는 경우 실패 합니다. 확장 된 오류 정보를 얻을 하려면 GetLastError.

주의

일반적으로 주 메시지 루프를 종료 하 고 프로그램을 종료 합니다 것인지 결정 반환 값을 사용 하는 응용 프로그램.

GetMessage 함수는만 hWnd 매개 변수 또는 메시지 값 wMsgFilterMinwMsgFilterMax 매개 변수에 의해 지정 된 범위 내에서 IsChild 함수에 의해 지정 된 대로 자식을 식별 하는 창에 연결 된 메시지를 검색 합니다. HWnd NULL 이면 GetMessage PostThreadMessage통해 호출 하는 스레드를 게시 스레드 메시지와 호출 하는 스레드에 속한 모든 창에 대 한 메시지를 검색 합니다. GetMessage hWnd NULL이 아닌 경우에 다른 스레드에 속해 있는 windows도 호출 하는 스레드 이외의 스레드 메시지를 검색 하지 않습니다. NULL 메시지 hWnd 값, PostThreadMessage 함수에 의해 게시 된 메시지를 스레드. WMsgFilterMinwMsgFilterMax 는 모두 0, GetMessage 모든 가능한 메시지를 반환 합니다 (즉, 범위 필터링 수행).

WM_KEYFIRST 및 WM_KEYLAST 상수는 키보드 입력;에 관련 된 모든 메시지를 검색 하려면 필터 값으로 사용할 수 있습니다. 모든 마우스 메시지를 검색 하는 WM_MOUSEFIRST 및 WM_MOUSELAST 상수를 사용할 수 있습니다. GetMessage 함수 (즉, 어떤 수행 하지 않고 필터링) 사용 가능한 모든 메시지를 반환 한다 wMsgFilterMinwMsgFilterMax 매개 변수에 모두 0 인 경우.

GetMessage 큐에서 WM_PAINT 메시지를 제거 하지 않습니다. 메시지가 처리 될 때까지 큐에 남아.

함수 반환 값, 0이 아닌 수 있습니다 0 또는-1. 따라서, 같은 코드를 피해 야 한다:

(GetMessage (lpMsg, hWnd, 0, 0)) 동안... 
 

-1 반환 값의 가능성을 의미 같은 코드 치명적인 응용 프로그램 오류가 발생할 수 있습니다.

QuickInfo

nbsp;?Windows &NT: 버전 3.1 이상이 필요 합니다.
Windows:Windows 95 이상이 필요합니다.
Windows CE:버전 1.0 이상이 필요합니다.
헤더:Winuser.h에서 선언합니다.
가져오기 라이브러리:User32.lib를 사용 합니다.
유니코드:Windows NT에서 유니코드와 ANSI 버전으로 구현.

참고 항목

메시지와 메시지 큐 개요, 메시지 및 메시지 큐 기능, IsChild, MSG, PeekMessage, postmessage를, PostThreadMessage, WaitMessage

 

Index