Функция 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 . Это происходит из lParam в WM_INPUT.

[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.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	winuser.h (включая Windows.h)
Библиотека	User32.lib
DLL	User32.dll
Набор API	ext-ms-win-ntuser-rawinput-l1-1-0 (появилось в Windows 10, версия 10.0.14393)