Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All
URB
Expand Minimize

USB_NODE_CONNECTION_INFORMATION_EX structure

The USB_NODE_CONNECTION_INFORMATION_EX structure is used in conjunction with the IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX request to obtain information about the connection associated with the indicated USB port.

Syntax


typedef struct _USB_NODE_CONNECTION_INFORMATION_EX {
  ULONG                 ConnectionIndex;
  USB_DEVICE_DESCRIPTOR DeviceDescriptor;
  UCHAR                 CurrentConfigurationValue;
  UCHAR                 Speed;
  BOOLEAN               DeviceIsHub;
  USHORT                DeviceAddress;
  ULONG                 NumberOfOpenPipes;
  USB_CONNECTION_STATUS ConnectionStatus;
  USB_PIPE_INFO         PipeList[];
} USB_NODE_CONNECTION_INFORMATION_EX, *PUSB_NODE_CONNECTION_INFORMATION_EX;

Members

ConnectionIndex

Contains a value greater than or equal to 1 that specifies the number of the port.

DeviceDescriptor

Contains a structure of type USB_DEVICE_DESCRIPTOR that reports the USB device descriptor returned by the attached device during enumeration.

CurrentConfigurationValue

Contains the ID used with the SetConfiguration request to specify that current configuration of the device connected to the indicated port. For an explanation of this value, see the Universal Serial Bus Specification.

Speed

Contains a value of type USB_DEVICE_SPEED that indicates the speed of the device.

DeviceIsHub

Indicates, when TRUE, that the device attached to the port is a hub.

DeviceAddress

Contains the USB-assigned, bus-relative address of the device that is attached to the port.

NumberOfOpenPipes

Indicates the number of open USB pipes associated with the port.

ConnectionStatus

Contains an enumerator of type USB_CONNECTION_STATUS that indicates the connection status.

PipeList

Contains an array of structures of type USB_PIPE_INFO that describes the open pipes associated with the port. Pipe descriptions include the schedule offset of the pipe and the associated endpoint descriptor. This information can be used to calculate bandwidth usage.

Remarks

If there is no device connected, IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX just returns information about the port. If a device is connected to the port IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX returns information about both the port and the connected device.

The USB_NODE_CONNECTION_INFORMATION_EX structure is an extended version of USB_NODE_CONNECTION_INFORMATION. The two structures are identical, except for one member. In the extended structure, the Speed member indicates the device speed.

The Speed member of the USB_NODE_CONNECTION_INFORMATION_EX structure is a UCHAR and it can specify any of the values of the USB_DEVICE_SPEED enumerator.

Requirements

Header

Usbioctl.h (include Usbioctl.h)

See also

USB_CONNECTION_STATUS
USB_PIPE_INFO
USB Structures

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft