Поделиться через


Функция GetRawInputData (winuser.h)

Извлекает необработанные входные данные с указанного устройства.

Синтаксис

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.

Комментарии

GetRawInputData получает необработанные входные данные по одной структуре RAWINPUT за раз. В отличие от этого, GetRawInputBuffer получает массив структур RAWINPUT .

Требования

Требование Значение
Минимальная версия клиента 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)

См. также раздел

Основные понятия

GetRawInputBuffer

RAWINPUT

RAWINPUTHEADER

Необработанные входные данные

Справочные материалы