estructura USB_NODE_CONNECTION_INFORMATION_EX (usbioctl.h)

  • Artículo

La estructura USB_NODE_CONNECTION_INFORMATION_EX se usa junto con la solicitud IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX para obtener información sobre la conexión asociada al puerto USB indicado.

Sintaxis

typedef struct _USB_NODE_CONNECTION_INFORMATION_EX {
  ULONG                 ConnectionIndex;
  USB_DEVICE_DESCRIPTOR DeviceDescriptor;
  UCHAR                 CurrentConfigurationValue;
  UCHAR                 Speed;
  BOOLEAN               DeviceIsHub;
  USHORT                DeviceAddress;
  ULONG                 NumberOfOpenPipes;
  USB_CONNECTION_STATUS ConnectionStatus;
  USB_PIPE_INFO         PipeList[0];
} USB_NODE_CONNECTION_INFORMATION_EX, *PUSB_NODE_CONNECTION_INFORMATION_EX;

Miembros

ConnectionIndex

Contiene un valor mayor o igual que 1 que especifica el número del puerto.

DeviceDescriptor

Contiene una estructura de tipo USB_DEVICE_DESCRIPTOR que informa del descriptor de dispositivo USB devuelto por el dispositivo conectado durante la enumeración.

CurrentConfigurationValue

Contiene el identificador usado con la solicitud SetConfiguration para especificar la configuración actual del dispositivo conectado al puerto indicado. Para obtener una explicación de este valor, vea la sección 9.4.7 en la especificación universal de Bus serie 3.1 disponible en la biblioteca de documentos USB.

Speed

Contiene un valor de tipo USB_DEVICE_SPEED que indica la velocidad del dispositivo.

DeviceIsHub

Indica, cuando es TRUE, que el dispositivo conectado al puerto es un centro.

DeviceAddress

Contiene la dirección relativa de bus asignada por USB del dispositivo que está conectado al puerto.

NumberOfOpenPipes

Indica el número de canalizaciones USB abiertas asociadas al puerto.

ConnectionStatus

Contiene un enumerador de tipo USB_CONNECTION_STATUS que indica el estado de conexión.

PipeList[0]

Contiene una matriz de estructuras de tipo USB_PIPE_INFO que describe las canalizaciones abiertas asociadas al puerto. Las descripciones de canalización incluyen el desplazamiento de programación de la canalización y el descriptor de punto de conexión asociado. Esta información se puede usar para calcular el uso del ancho de banda.

Comentarios

Si no hay ningún dispositivo conectado, IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX simplemente devuelve información sobre el puerto. Si un dispositivo está conectado al puerto IOCTL_USB_GET_NODE_CONNECTION_INFORMATION_EX devuelve información sobre el puerto y el dispositivo conectado.

La estructura USB_NODE_CONNECTION_INFORMATION_EX es una versión extendida de USB_NODE_CONNECTION_INFORMATION. Las dos estructuras son idénticas, excepto para un miembro. En la estructura extendida, el miembro Speed indica la velocidad del dispositivo.

El miembro Speed de la estructura USB_NODE_CONNECTION_INFORMATION_EX es un UCHAR y puede especificar cualquiera de los valores del enumerador USB_DEVICE_SPEED . El miembro Speed admite hasta UsbHighSpeed (USB 2.0). Para determinar si un dispositivo admite UsbSuperSpeed (USB 3.0), use la estructura USB_NODE_CONNECTION_INFORMATION_EX_V2 .

El siguiente fragmento de código de C++ del ejemplo USBView muestra cómo determinar si un dispositivo admite UsbSuperSpeed (USB 3.0):

// Since the USB_NODE_CONNECTION_INFORMATION_EX is used to display
// the device speed, but the hub driver doesn't support indication
// of superspeed, we overwrite the value if the super speed
// data structures are available and indicate the device is operating
// at SuperSpeed.

if (connectionInfoEx->Speed == UsbHighSpeed 
    && connectionInfoExV2 != NULL 
    && (connectionInfoExV2->Flags.DeviceIsOperatingAtSuperSpeedOrHigher ||
        connectionInfoExV2->Flags.DeviceIsOperatingAtSuperSpeedPlusOrHigher))
{
    connectionInfoEx->Speed = UsbSuperSpeed;
}

Requisitos

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

Consulte también