estructura USB_DEVICE_DESCRIPTOR (usbspec.h)

  • Artículo

Los controladores de cliente USB usan la estructura USB_DEVICE_DESCRIPTOR para recuperar un descriptor de dispositivo definido por USB. Los miembros de esta estructura se describen en la especificación Universal Serial Bus 3.1 disponible en la Biblioteca de documentos USB. Consulte la sección 9.6.1.

Sintaxis

typedef struct _USB_DEVICE_DESCRIPTOR {
  UCHAR  bLength;
  UCHAR  bDescriptorType;
  USHORT bcdUSB;
  UCHAR  bDeviceClass;
  UCHAR  bDeviceSubClass;
  UCHAR  bDeviceProtocol;
  UCHAR  bMaxPacketSize0;
  USHORT idVendor;
  USHORT idProduct;
  USHORT bcdDevice;
  UCHAR  iManufacturer;
  UCHAR  iProduct;
  UCHAR  iSerialNumber;
  UCHAR  bNumConfigurations;
} USB_DEVICE_DESCRIPTOR, *PUSB_DEVICE_DESCRIPTOR;

Miembros

bLength

Especifica la longitud, en bytes, de este descriptor.

bDescriptorType

Especifica el tipo de descriptor. Debe establecerse en USB_DEVICE_DESCRIPTOR_TYPE.

bcdUSB

Identifica la versión de la especificación USB con la que cumple esta estructura de descriptores. Este valor es un número decimal codificado binario.

bDeviceClass

Especifica el código de clase del dispositivo asignado por el grupo de especificaciones USB.

bDeviceSubClass

Especifica el código de subclase del dispositivo asignado por el grupo de especificaciones USB.

bDeviceProtocol

Especifica el código de protocolo del dispositivo asignado por el grupo de especificaciones USB.

bMaxPacketSize0

Especifica el tamaño máximo de paquete, en bytes, para el punto de conexión cero del dispositivo. El valor debe establecerse en 8, 16, 32 o 64.

idVendor

Especifica el identificador de proveedor del dispositivo según lo asignado por el comité de especificación USB.

idProduct

Especifica el identificador del producto. El fabricante asigna este valor y es específico del dispositivo.

bcdDevice

Identifica la versión del dispositivo. Este valor es un número decimal codificado binario.

iManufacturer

Especifica un índice definido por el dispositivo del descriptor de cadena que proporciona una cadena que contiene el nombre del fabricante de este dispositivo.

iProduct

Especifica un índice definido por el dispositivo del descriptor de cadena que proporciona una cadena que contiene una descripción del dispositivo.

iSerialNumber

Especifica un índice definido por el dispositivo del descriptor de cadena que proporciona una cadena que contiene un número de serie determinado por el fabricante para el dispositivo.

bNumConfigurations

Especifica el número total de configuraciones posibles para el dispositivo.

Comentarios

Esta estructura se usa para contener un descriptor de dispositivo definido por USB recuperado. Esta información se puede usar para configurar o recuperar más información sobre el dispositivo. Los descriptores de dispositivo se recuperan mediante el envío de un URB get-descriptor.

Los valores iManufacturer, iProduct e iSerialNumber , cuando se devuelven desde el controlador del controlador de host, contienen valores de índice en una matriz de descriptores de cadena mantenidos por el dispositivo. Para recuperar estas cadenas, se puede enviar una solicitud de descriptor de cadena al dispositivo mediante estos valores de índice.

Requisitos

Requisito Valor
Header usbspec.h (incluye Usb100.h)

Consulte también

Estructuras USB

UsbBuildGetDescriptorRequest

_URB_CONTROL_DESCRIPTOR_REQUEST