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

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

Синтаксис

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

Параметры

[in] pRawInputDevices

Тип: PCRAWINPUTDEVICE

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

[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 не следует использовать из библиотеки, так как он может препятствовать любой логике обработки необработанных входных данных, уже присутствующей в приложениях, которые загружают его.

Требования

См. также

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

RAWINPUTDEVICE

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

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

WM_INPUT