IOCTL_USB_GET_NODE_CONNECTION_INFORMATION control code

The IOCTL_USB_GET_NODE_CONNECTION_INFORMATION request retrieves information about the indicated 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 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 Buffer

The AssociatedIrp.SystemBuffer member points to a user-allocated USB_NODE_CONNECTION_INFORMATION structure that describes the connection. On input, the ConnectionIndex member of this structure contains the port number.

Input Buffer Length

The size of a USB_NODE_CONNECTION_INFORMATION structure.

Output Buffer

On output, the Parameters.DeviceIoControl.OutputBufferLength member contains the size of the output data. This size is variable, because it depends on the number of pipes that are associated with the port.

AssociatedIrp.SystemBuffer points to a user-allocated USB_NODE_CONNECTION_INFORMATION structure that contains the output data.

Output Buffer Length

The size of a USB_NODE_CONNECTION_INFORMATION structure.

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.

Remarks

The IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX request is an extended version of IOCTL_USB_GET_NODE_CONNECTION_INFORMATION. The two requests are identical, except that the extended version of the request can report low, full, and high speed connections and the older IOCTL_USB_GET_NODE_CONNECTION_INFORMATION request reports only low and full speed connections. For more information about the difference between these two requests, see USB_NODE_CONNECTION_INFORMATION and USB_NODE_CONNECTION_INFORMATION_EX.

Requirements

Header

Usbioctl.h (include Usbioctl.h)

See also

IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX
USB_NODE_CONNECTION_INFORMATION
USB_NODE_CONNECTION_INFORMATION_EX

 

 

Send comments about this topic to Microsoft

Show: