Expand Minimize

IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES control code

The IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES I/O control request retrieves the Microsoft-extended port attributes for a specific port.

IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES is a user-mode I/O control request. This request targets the USB hub device (GUID_DEVINTERFACE_USB_HUB).

Input Parameters

The AssociatedIrp.SystemBuffer member points to a user-allocated USB_NODE_CONNECTION_ATTRIBUTES structure. On input, the caller specifies the port number in the ConnectionIndex member of a USB_NODE_CONNECTION_ATTRIBUTES structure.

Output Parameters

On output, the USB_NODE_CONNECTION_ATTRIBUTES structure at AssociatedIrp.SystemBuffer describes the Microsoft-extended port attributes for the port.

Note  For Windows Vista, Windows Server 2008, and Windows 7, the Microsoft-extended port attributes field is set to zero.

For Windows XP and Windows Server 2003, the Microsoft-extended port attribute might be set to USB_PORTATTR_NO_OVERCURRENT_UI. This value indicates that user interface will be hidden when an overcurrent occurs on the port.

Parameters.DeviceIoControl.OutputBufferLength indicates the size, in bytes, of the data returned at 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. If the hub has not been started or is not functional, the request returns STATUS_UNSUCCESSFUL.

Requirements

Version

Windows XP, Windows Server 2003, and later.

Header

Usbioctl.h (include Usbioctl.h)

See also

USB_NODE_CONNECTION_ATTRIBUTES
USB IOCTLs

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft