GetRawInputData 함수(winuser.h)

아티클
08/27/2023

지정된 디바이스에서 원시 입력을 검색합니다.

구문

UINT GetRawInputData(
  [in]            HRAWINPUT hRawInput,
  [in]            UINT      uiCommand,
  [out, optional] LPVOID    pData,
  [in, out]       PUINT     pcbSize,
  [in]            UINT      cbSizeHeader
);

매개 변수

[in] hRawInput

형식: HRAWINPUT

RAWINPUT 구조체에 대한 핸들입니다. 이것은 WM_INPUTlParam에서 비롯되었습니다.

[in] uiCommand

형식: UINT

명령 플래그입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값	의미
RID_HEADER 0x10000005	RAWINPUT 구조에서 헤더 정보를 가져옵니다.
RID_INPUT 0x10000003	RAWINPUT 구조에서 원시 데이터를 가져옵니다.

[out, optional] pData

형식: LPVOID

RAWINPUT 구조에서 가져온 데이터에 대한 포인터입니다. 이는 uiCommand의 값에 따라 달라집니다. pData가 NULL이면 버퍼의 필수 크기가 *pcbSize로 반환됩니다.

[in, out] pcbSize

형식: PUINT

pData에 있는 데이터의 크기(바이트)입니다.

[in] cbSizeHeader

형식: UINT

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

반환 값

형식: UINT

pData가 NULL이고 함수가 성공하면 반환 값은 0입니다. pData가 NULL이 아니고 함수가 성공하면 반환 값은 pData에 복사된 바이트 수입니다.

오류가 있는 경우 반환 값은 (UINT)-1입니다.

설명

GetRawInputData 는 원시 입력을 한 번에 하나의 RAWINPUT 구조를 가져옵니다. 반면 GetRawInputBuffer 는 RAWINPUT 구조체의 배열을 가져옵니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	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에 도입됨)