IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX control code
The IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX request retrieves information about a USB port and the device that is attached to the port, if there is one.
Client drivers must send this IOCTL at an IRQL of PASSIVE_LEVEL.
IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX is a user-mode I/O control request. This request targets the USB hub device (GUID_DEVINTERFACE_USB_HUB). Do not send this request to the root hub.
The AssociatedIrp.SystemBuffer member points to a USB_NODE_CONNECTION_INFORMATION_EX structure. On input, the ConnectionIndex member of this structure must contain a number greater than or equal to 1 that indicates the number of the port whose connection information is to be reported. The hub driver returns connection information in the remaining members of USB_NODE_CONNECTION_INFORMATION_EX.
The USB hub driver will return information about the indicated connection in the USB_NODE_CONNECTION_INFORMATION_EX structure that is pointed to by AssociatedIrp.SystemBuffer.
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.
|Windows XP, Windows Server 2003, and later.|