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

  • Статья

Регистрирует устройства, которые предоставляют необработанные входные данные.

Синтаксис

BOOL RegisterRawInputDevices(
  [in] PCRAWINPUTDEVICE pRawInputDevices,
  [in] UINT             uiNumDevices,
  [in] UINT             cbSize
);

Параметры

[in] pRawInputDevices

Тип: PCRAWINPUTDEVICE

Массив структур RAWINPUTDEVICE , представляющих устройства, которые предоставляют необработанные входные данные.

[in] uiNumDevices

Тип: UINT

Число структур RAWINPUTDEVICE , на которые указывает pRawInputDevices.

[in] cbSize

Тип: UINT

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

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

Тип: BOOL

Значение TRUE , если функция выполнена успешно; в противном случае — FALSE. Если функция завершается сбоем, вызовите Метод GetLastError для получения дополнительных сведений.

Комментарии

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

Для получения WM_INPUT_DEVICE_CHANGE сообщений приложение должно указать флаг RIDEV_DEVNOTIFY для каждого класса устройства, заданного полями usUsagePage и usUsage структуры RAWINPUTDEVICE . По умолчанию приложение не получает WM_INPUT_DEVICE_CHANGE уведомлений о поступлении и удалении необработанного устройства ввода.

Если в структуре RAWINPUTDEVICE установлен флаг RIDEV_REMOVE, а параметр hwndTarget не имеет значения NULL, проверка параметра завершится ошибкой.

Для получения необработанных входных данных в рамках процесса может быть зарегистрировано только одно окно для каждого класса необработанного устройства ввода (окно, переданное в последнем вызове RegisterRawInputDevices). По этой причине RegisterRawInputDevices не следует использовать из библиотеки, так как это может помешать любой логике обработки необработанных входных данных, уже присутствующей в приложениях, которые ее загружают.

Требования

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

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

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

RAWINPUTDEVICE

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

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

WM_INPUT