HUB_DEVICE_CONFIG_INFO structure (usbioctl.h)

The HUB_DEVICE_CONFIG_INFO structure is used in conjunction with the kernel-mode IOCTL, IOCTL_INTERNAL_USB_GET_DEVICE_CONFIG_INFO to request to report information about a USB device and the hub to which the device is attached.

Syntax

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;

Members

Version

Specifies the version number. Must be set to 1.

Length

Specifies the size of the HUB_DEVICE_CONFIG_INFO structure. Must be set by the caller.

HubFlags

Specifies the hub capabilities in a USB_HUB_CAP_FLAGS structure.

HardwareIds

The PnP hardware ID multi-string for the USB device in a USB_ID_STRING structure.

CompatibleIds

PnP compatible ID multi-string for the USB device in a USB_ID_STRING structure.

DeviceDescription

Description of the device in a USB_ID_STRING structure. This may be set to NULL.

Reserved[19]

Reserved.

UxdSettings

Remarks

The Buffer member of the USB_ID_STRING structure points to a string that contains HardwareIds, CompatibleIds, and DeviceDescription values. The caller is responsible for releasing this string buffer, which is allocated by the hub driver.

Requirements

See also

IOCTL_INTERNAL_USB_GET_DEVICE_CONFIG_INFO

USB Structures

USB_HUB_CAP_FLAGS

USB_ID_STRING