Функция 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) |
См. также раздел
Основные понятия
Справочные материалы