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