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


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

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

Синтаксис

UINT GetRegisteredRawInputDevices(
  [out, optional] PRAWINPUTDEVICE pRawInputDevices,
  [in, out]       PUINT           puiNumDevices,
  [in]            UINT            cbSize
);

Параметры

[out, optional] pRawInputDevices

Тип: PRAWINPUTDEVICE

Массив структур RAWINPUTDEVICE для приложения. Указатель должен быть выровнен на границе DWORD (32-разрядная версия).

[in, out] puiNumDevices

Тип: PUINT

Количество структур RAWINPUTDEVICE в *pRawInputDevices.

[in] cbSize

Тип: UINT

Размер структуры RAWINPUTDEVICE в байтах.

Возвращаемое значение

Тип: UINT

В случае успешного выполнения функция возвращает не отрицательное число, которое является числом структур RAWINPUTDEVICE , записанных в буфер.

Если буфер pRawInputDevices слишком мал или NULL, функция задает последнюю ошибку как ERROR_INSUFFICIENT_BUFFER, возвращает значение -1 и задает puiNumDevices требуемому количеству устройств. Если функция завершается ошибкой по какой-либо другой причине, она возвращает значение -1. Дополнительные сведения см. в вызове GetLastError.

Замечания

Чтобы получить необработанные входные данные с устройства, приложение должно зарегистрировать его с помощью RegisterRawInputDevices.

Требования

Требование Ценность
Минимальный поддерживаемый клиент Windows XP [только классические приложения]
минимальный поддерживаемый сервер Windows Server 2003 [только классические приложения]
целевая платформа Виндоус
Заголовок winuser.h (включая Windows.h)
Библиотека User32.lib
Библиотека dll User32.dll

См. также

Концептуальный

RAWINPUTDEVICE

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

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

RegisterRawInputDevices