IOCTL_USB_GET_HUB_CAPABILITIES_EX IOCTL (usbioctl.h)
The IOCTL_USB_GET_HUB_CAPABILITIES_EX I/O control request retrieves the capabilities of a USB hub.
IOCTL_USB_GET_HUB_CAPABILITIES_EX is a user-mode I/O control request. This request targets the USB hub device (GUID_DEVINTERFACE_USB_HUB).
Major code
Input buffer
The AssociatedIrp.SystemBuffer member points to a user-allocated buffer.
Input buffer length
The buffer length equals sizeof(USB_HUB_CAPABILITIES_EX)
.
Output buffer
AssociatedIrp.SystemBuffer points to a user-allocated USB_HUB_CAPABILITIES_EX structure. On output, this structure describes the hub capabilities.
Output buffer length
The Parameters.DeviceIoControl.OutputBufferLength member indicates the size, in bytes, of the data that is returned at SystemBuffer, or sizeof(USB_HUB_CAPABILITIES_EX)
.
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. If the hub has not been started or is not functional, the request returns STATUS_UNSUCCESSFUL.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows Vista and later. |
Header | usbioctl.h (include Usbioctl.h) |