RegisterRawInputDevices 함수(winuser.h)

원시 입력 데이터를 제공하는 디바이스를 등록합니다.

구문

BOOL RegisterRawInputDevices(
  [in] PCRAWINPUTDEVICE pRawInputDevices,
  [in] UINT             uiNumDevices,
  [in] UINT             cbSize
);

매개 변수

[in] pRawInputDevices

형식: PCRAWINPUTDEVICE

원시 입력을 제공하는 디바이스를 나타내는 RAWINPUTDEVICE 구조체의 배열입니다.

[in] uiNumDevices

형식: UINT

pRawInputDevices가 가리키는 RAWINPUTDEVICE 구조체의 수입니다.

[in] cbSize

형식: UINT

RAWINPUTDEVICE 구조체의 크기(바이트)입니다.

반환 값

형식: BOOL

함수가 성공하면 TRUE입니다. 그렇지 않으면 FALSE입니다. 함수가 실패하면 GetLastError 를 호출하여 자세한 내용을 확인합니다.

설명

WM_INPUT 메시지를 받으려면 애플리케이션이 먼저 RegisterRawInputDevices를 사용하여 원시 입력 디바이스를 등록해야 합니다. 기본적으로 애플리케이션은 원시 입력을 받지 않습니다.

WM_INPUT_DEVICE_CHANGE 메시지를 수신하려면 애플리케이션이 RAWINPUTDEVICE 구조의 usUsagePage 및 usUsage 필드에 지정된 각 디바이스 클래스에 대한 RIDEV_DEVNOTIFY 플래그를 지정해야 합니다. 기본적으로 애플리케이션은 원시 입력 디바이스 도착 및 제거에 대한 WM_INPUT_DEVICE_CHANGE 알림을 받지 않습니다.

RAWINPUTDEVICE 구조체에 RIDEV_REMOVE 플래그가 설정되어 있고 hwndTarget 매개 변수가 NULL로 설정되지 않은 경우 매개 변수 유효성 검사가 실패합니다.

프로세스 내에서 원시 입력을 수신하도록 원시 입력 디바이스 클래스당 하나의 창만 등록할 수 있습니다(RegisterRawInputDevices에 대한 마지막 호출에서 전달된 창). 따라서 RegisterRawInputDevices는 라이브러리를 로드하는 애플리케이션에 이미 있는 원시 입력 처리 논리를 방해할 수 있으므로 라이브러리에서 사용하면 안 됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	winuser.h(Windows.h 포함)
라이브러리	User32.lib
DLL	User32.dll
API 세트	ext-ms-win-ntuser-rawinput-l1-1-0(Windows 10 버전 10.0.14393에 도입됨)

추가 정보

개념

RAWINPUTDEVICE

원시 입력

참조

WM_INPUT