Share via


IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES IOCTL (usbioctl.h)

La IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES solicitud de control de E/S recupera los atributos de puerto extendido de Microsoft para un puerto específico.

IOCTL_USB_GET_NODE_CONNECTION_ATTRIBUTES es una solicitud de control de E/S en modo de usuario. Esta solicitud tiene como destino el dispositivo concentrador USB (GUID_DEVINTERFACE_USB_HUB).

Código principal

IRP_MJ_DEVICE_CONTROL

Búfer de entrada

El miembro AssociatedIrp.SystemBuffer apunta a una estructura de USB_NODE_CONNECTION_ATTRIBUTES asignada por el usuario. En la entrada, el autor de la llamada especifica el número de puerto en el miembro ConnectionIndex de una estructura de USB_NODE_CONNECTION_ATTRIBUTES .

Longitud del búfer de entrada

Tamaño de una estructura de USB_NODE_CONNECTION_ATTRIBUTES .

Búfer de salida

En la salida, la estructura de USB_NODE_CONNECTION_ATTRIBUTES en AssociatedIrp.SystemBuffer describe los atributos de puerto extendidos de Microsoft para el puerto. Nota Para Windows Vista, Windows Server 2008 y Windows 7, el campo atributos de puerto extendido de Microsoft se establece en cero.

Para Windows XP y Windows Server 2003, el atributo de puerto extendido de Microsoft se puede establecer en USB_PORTATTR_NO_OVERCURRENT_UI. Este valor indica que la interfaz de usuario se ocultará cuando se produzca una sobrecurrencia en el puerto.

Longitud del búfer de salida

Parameters.DeviceIoControl.OutputBufferLength indica el tamaño, en bytes, de los datos devueltos en SystemBuffer.

Bloque de estado

La pila USB establece Irp-IoStatus.Status> en STATUS_SUCCESS si la solicitud se realiza correctamente. De lo contrario, la pila USB establece Estado en la condición de error adecuada, como STATUS_INVALID_PARAMETER o STATUS_INSUFFICIENT_RESOURCES. Si el centro no se ha iniciado o no es funcional, la solicitud devuelve STATUS_UNSUCCESSFUL.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP, Windows Server 2003 y versiones posteriores.
Encabezado usbioctl.h (incluya Usbioctl.h)

Consulte también

USB_NODE_CONNECTION_ATTRIBUTES