Функция 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

Флаг команды. Этот параметр может принимать одно из указанных ниже значений.

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

Требования

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

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

GetRawInputBuffer

RAWINPUT

RAWINPUTHEADER

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

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