Share via

IOCTL_USB_GET_NODE_CONNECTION_INFORMATION IOCTL (usbioctl.h)

  • Artículo

La solicitud IOCTL_USB_GET_NODE_CONNECTION_INFORMATION recupera información sobre el puerto USB indicado y el dispositivo que está conectado al puerto, si hay alguno.

Los controladores de cliente deben enviar este IOCTL en un IRQL de PASSIVE_LEVEL.

IOCTL_USB_GET_NODE_CONNECTION_INFORMATION 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_INFORMATION asignada por el usuario que describe la conexión. En la entrada, el miembro ConnectionIndex de esta estructura contiene el número de puerto.

Longitud del búfer de entrada

Tamaño de una estructura de USB_NODE_CONNECTION_INFORMATION .

Búfer de salida

En la salida, el miembro Parameters.DeviceIoControl.OutputBufferLength contiene el tamaño de los datos de salida. Este tamaño es variable, ya que depende del número de canalizaciones asociadas al puerto.

AssociatedIrp.SystemBuffer apunta a una estructura de USB_NODE_CONNECTION_INFORMATION asignada por el usuario que contiene los datos de salida.

Longitud del búfer de salida

Tamaño de una estructura de USB_NODE_CONNECTION_INFORMATION .

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.

Comentarios

La solicitud de IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX es una versión extendida de IOCTL_USB_GET_NODE_CONNECTION_INFORMATION. Las dos solicitudes son idénticas, salvo que la versión extendida de la solicitud puede notificar conexiones de baja, completa y alta velocidad y las anteriores IOCTL_USB_GET_NODE_CONNECTION_INFORMATION solicitudes solo notifican conexiones de velocidad baja y completa. Para obtener más información sobre la diferencia entre estas dos solicitudes, consulte USB_NODE_CONNECTION_INFORMATION y USB_NODE_CONNECTION_INFORMATION_EX.

Requisitos

Requisito Valor
Header usbioctl.h (incluya Usbioctl.h)

Consulte también

IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX

USB_NODE_CONNECTION_INFORMATION

USB_NODE_CONNECTION_INFORMATION_EX