<aside> 💡

HWND과 HINSTANCE는 다른 개념

</aside>

• 핸들

  • WinAPI에서 핸들(handle) 은 운영체제(OS)가 관리하는 다양한 객체(예: 윈도우, 파일, GDI 객체, 스레드 등)를 식별하기 위한 참조자
  • 핸들은 내부 데이터 구조의 세부 사항을 감추고, 단지 OS가 해당 객체를 찾거나 조작할 수 있도록 하는 역할

• HWND

  • Windows 운영체제에서 특정 윈도우(창)를 식별하기 위한 핸들
  • 윈도우의 위치, 크기, 상태, 메시지 처리 등 개별 창에 관한 정보와 관련된 작업을 수행할 때 사용

• HINSTANCE

  • HINSTANCE는 실행 중인 애플리케이션의 인스턴스를 나타내는 핸들
  • 애플리케이션(프로그램)을 식별하기 위한 핸들
  • Win32 애플리케이션의 진입점 함수인 WinMain에서 첫 번째 매개변수로 전달받음

  int APIENTRY wWinMain(_In_ HINSTANCE hInstance,
  					  _In_opt_ HINSTANCE hPrevInstance,
  					  _In_ LPWSTR    lpCmdLine,
  					  _In_ int       nCmdShow)
  
  // hInstance를 제외한 나머지 매개변수들은 중요하지 않음					 
  					 
  /* 
  여기서 전달받은 hInstance를 InitInstance (hInstance, nCmdShow) 함수에서
  전역변수 hInst에 저장
  */
  	
  	
  hInst = hInstance; // Store instance handle in our global variable
  

• Window 클래스

  • 윈도우를 표시하기 전에 Window 클래스를 생성하고 등록해야함
  • Window 클래스는 윈도우의 초기설정 중 일부를 정의하는 클래스
  • WNDCLASSEX 구조체에 값을 채워 넣어 윈도우를 설정가능
  • RegisterClassEx 함수를 통해 생성한 Window클래스를 등록
  • Window 클래스 등록이후 CreateWindow 함수로 윈도우 생성가능

TranslateMessage 공식문서 https://learn.microsoft.com/ko-kr/windows/win32/api/winuser/nf-winuser-translatemessage

WM_CHAR 공식문서 https://learn.microsoft.com/ko-kr/windows/win32/inputdev/wm-char

• 메세지 루프

  • 윈도우는 메세지 전송을 통해 프로그램과 의사소통
  • 메세지들은 마우스 움직임이나 키 입력같은 사용자 작업, 또는 윈도우에서 보내는 명령을 아리는데 사용됨
  • WinMain의 루프는 메세지를 확인하는데 사용
  • 애플리케이션이 사용자로부터 문자를 입력받았다면 메세지 루프안에서 TranslateMessage 함수를 호출해야함
  • TranslateMessage 는 가상 키 메세지를 문자 메세지(WM_CHAR)로 변환하는 윈도우 함수
  • 메세지는 처리를 위해 DispatchMessage 함수를 통해 WinProc 함수로 보내짐
  • WinMain은 WM_QUIT 메세지를 받을 때까지 루프를 반복수행

• 가상 키코드

  • WM_KEYDOWN, WM_KEYUP, WM_SYSKEYDOWN, WM_SYSKEYUP 등

• WM_CHAR

  • WM_CHAR 메시지는 실제로의 문자 코드가 포함됨
  • 예를 들어, 사용자가 'A' 키를 눌렀을 때 WM_CHAR 메시지에는 눌린 키에 해당하는 문자 코드가 포함됨
  • WM_CHAR 메시지는 wParam, lParam 로 구성됨
  • wParam: 누른 키에 해당하는 문자 코드 (예: 'A', 'a', '1' 등)
  • lParam: 반복 횟수, 스캔 코드 등 추가 정보가 포함되어 있음 (공식문서 참고할 것)

<aside> 💡

게임의 메세지 루프 안에서는 GetMessage말고 PeekMessage를 사용해야함

GetMessage는 Blocking함수로 리턴되기전에 메세지를 기다림

PeekMessage는 Non-Blocking함수로 기다리지 않음

</aside>