структура HUB_DEVICE_CONFIG_INFO (usbioctl.h)

Статья
02/07/2025

Структура HUB_DEVICE_CONFIG_INFO используется вместе с IOCTL в режиме ядра, IOCTL_INTERNAL_USB_GET_DEVICE_CONFIG_INFO запрашивать сведения о USB-устройстве и концентраторе, к которому подключено устройство.

Синтаксис

typedef struct _HUB_DEVICE_CONFIG_INFO_V1 {
  ULONG                       Version;
  ULONG                       Length;
  USB_HUB_CAP_FLAGS           HubFlags;
  USB_ID_STRING               HardwareIds;
  USB_ID_STRING               CompatibleIds;
  USB_ID_STRING               DeviceDescription;
  ULONG                       Reserved[19];
  USB_HUB_DEVICE_UXD_SETTINGS UxdSettings;
} HUB_DEVICE_CONFIG_INFO, *PHUB_DEVICE_CONFIG_INFO;

Члены

Version

Указывает номер версии. Должно быть установлено значение 1.

Length

Задает размер структуры HUB_DEVICE_CONFIG_INFO. Необходимо задать вызывающим абонентом.

HubFlags

Задает возможности концентратора в структуре USB_HUB_CAP_FLAGS.

HardwareIds

Идентификатор оборудования PnP с несколькими строками для USB-устройства в структуре USB_ID_STRING.

CompatibleIds

PnP-совместимый идентификатор с несколькими строками для USB-устройства в USB_ID_STRING структуре.

DeviceDescription

Описание устройства в структуре USB_ID_STRING. Это может быть задано значение NULL.

Reserved[19]

Скрытный.

UxdSettings

Замечания

Элемент буфера структуры USB_ID_STRING указывает на строку, содержащую значения HardwareIds, CompatibleIdsи значения DeviceDescription. Вызывающий объект отвечает за освобождение этого строкового буфера, который выделяется драйвером концентратора.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно в Windows XP и более поздних операционных системах.
заголовка	usbioctl.h (include Usbioctl.h)

См. также

IOCTL_INTERNAL_USB_GET_DEVICE_CONFIG_INFO

СТРУКТУРЫ USB

USB_HUB_CAP_FLAGS

USB_ID_STRING

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