IOCTL_USB_GET_NODE_CONNECTION_INFORMATION IOCTL (usbioctl.h)
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
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