struttura USB_DEVICE_DESCRIPTOR (usbspec.h)

Articolo
08/07/2023

La struttura USB_DEVICE_DESCRIPTOR viene usata dai driver client USB per recuperare un descrittore di dispositivo definito da USB. I membri di questa struttura sono descritti nella specifica Universal Serial Bus 3.1 disponibile nella raccolta documenti USB. Vedere la sezione 9.6.1.

Sintassi

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;

Members

bLength

Specifica la lunghezza, in byte, di questo descrittore.

bDescriptorType

Specifica il tipo di descrittore. Deve essere impostato su USB_DEVICE_DESCRIPTOR_TYPE.

bcdUSB

Identifica la versione della specifica USB con cui è conforme questa struttura del descrittore. Questo valore è un numero decimale codificato in formato binario.

bDeviceClass

Specifica il codice di classe del dispositivo assegnato dal gruppo di specifiche USB.

bDeviceSubClass

Specifica il codice della sottoclasse del dispositivo assegnato dal gruppo di specifiche USB.

bDeviceProtocol

Specifica il codice di protocollo del dispositivo assegnato dal gruppo di specifiche USB.

bMaxPacketSize0

Specifica la dimensione massima del pacchetto, in byte, per l'endpoint zero del dispositivo. Il valore deve essere impostato su 8, 16, 32 o 64.

idVendor

Specifica l'identificatore del fornitore per il dispositivo assegnato dal comitato di specifica USB.

idProduct

Specifica l'identificatore del prodotto. Questo valore viene assegnato dal produttore ed è specifico del dispositivo.

bcdDevice

Identifica la versione del dispositivo. Questo valore è un numero decimale codificato in formato binario.

iManufacturer

Specifica un indice definito dal dispositivo del descrittore di stringa che fornisce una stringa contenente il nome del produttore del dispositivo.

iProduct

Specifica un indice definito dal dispositivo del descrittore di stringa che fornisce una stringa contenente una descrizione del dispositivo.

iSerialNumber

Specifica un indice definito dal dispositivo del descrittore di stringa che fornisce una stringa contenente un numero di serie determinato dal produttore per il dispositivo.

bNumConfigurations

Specifica il numero totale di configurazioni possibili per il dispositivo.

Commenti

Questa struttura viene usata per contenere un descrittore di dispositivo definito tramite USB recuperato. Queste informazioni possono quindi essere usate per configurare o recuperare informazioni sul dispositivo. I descrittori di dispositivo vengono recuperati inviando un descrittore GET.

I valori iManufacturer, iProduct e iSerialNumber , se restituiti dal driver del controller host, contengono valori di indice in una matrice di descrittori stringa gestiti dal dispositivo. Per recuperare queste stringhe, è possibile inviare una richiesta di descrittore di stringa al dispositivo usando questi valori di indice.

Requisiti

Requisito	Valore
Intestazione	usbspec.h (include Usb100.h)

Vedi anche

Strutture USB

UsbBuildGetDescriptorRequest

_URB_CONTROL_DESCRIPTOR_REQUEST

Condividi tramite