Skip to content

Latest commit

 

History

History
82 lines (61 loc) · 3.7 KB

ni-usbioctl-ioctl_usb_get_node_connection_attributes.md

File metadata and controls

82 lines (61 loc) · 3.7 KB
UID title description old-location tech.root ms.date keywords ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames f1_keywords topic_type api_type api_location api_name
NI:usbioctl.IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES
IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES (usbioctl.h)
The IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES I/O control request retrieves the Microsoft-extended port attributes for a specific port.
buses\ioctl_usb_get_node_connection_attributes.htm
usbref
05/07/2018
IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES IOCTL
IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES, IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES control, IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES control code [Buses], buses.ioctl_usb_get_node_connection_attributes, usbioctl/IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES, usbirp_7240de27-e12b-4c72-94c3-5913a217c0c3.xml
usbioctl.h
Usbioctl.h
Windows
Windows XP, Windows Server 2003, and later.
Windows
IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES
usbioctl/IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES
APIRef
kbSyntax
HeaderDef
Usbioctl.h
IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES

IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES IOCTL

-description

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).

-ioctlparameters

-ioctl-major-code

-input-buffer

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.

-input-buffer-length

The size of a USB_NODE_CONNECTION_ATTRIBUTES structure.

-output-buffer

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.

-output-buffer-length

Parameters.DeviceIoControl.OutputBufferLength indicates the size, in bytes, of the data returned at SystemBuffer.

-in-out-buffer

-inout-buffer-length

-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.

-see-also

USB_NODE_CONNECTION_ATTRIBUTES