IOCTL_USB_GET_HUB_CAPABILITIES IOCTL

The IOCTL_USB_GET_HUB_CAPABILITIES I/O control request retrieves the capabilities of a USB hub. Note  This request is replaced by IOCTL_USB_GET_HUB_CAPABILITIES_EX in Windows Vista.

IOCTL_USB_GET_HUB_CAPABILITIES is a user-mode I/O control request. This request targets the USB hub device (GUID_DEVINTERFACE_USB_HUB).

Major Code

IRP_MJ_DEVICE_CONTROL

Input Buffer

None.

Input Buffer Length

None.

Output Buffer

The AssociatedIrp.SystemBuffer member points to a user-allocated USB_HUB_CAPABILITIES structure that describes the hub capabilities.

Output Buffer Length

The Parameters.DeviceIoControl.OutputBufferLength member indicates the size, in bytes, of the output buffer in SystemBuffer. The output buffer size must be >= sizeof(USB_HUB_CAPABILITIES).

Status Block

The USB stack sets Irp->IoStatus.Status to STATUS_SUCCESS if the request is successful. Otherwise, the USB stack sets Status to the appropriate error condition, such as STATUS_INVALID_PARAMETER or STATUS_INSUFFICIENT_RESOURCES.

Requirements

   
Header usbioctl.h (include Usbioctl.h)

See Also

IOCTL_USB_GET_HUB_CAPABILITIES_EX

USB_HUB_CAPABILITIES