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


Функция 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. Указатель должен быть выровнен на границе DWORD (32-разрядная версия).

Если 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 [только классические приложения]
целевая платформа Виндоус
Заголовок 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

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

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