Expand Minimize

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.

Input Parameters

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.

Output Parameters

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.

I/O 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

Version

Windows XP, Windows Server 2003, and later.

Header

Usbioctl.h (include Usbioctl.h)

See also

USB_NODE_CONNECTION_INFORMATION
USB_NODE_CONNECTION_INFORMATION_EX
USB IOCTLs

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft