struttura USB_DEVICE_DESCRIPTOR (usbspec.h)
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 in 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;
Membri
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 del protocollo del dispositivo assegnato dal gruppo di specifiche USB.
bMaxPacketSize0
Specifica la dimensione massima del pacchetto, espressa 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.
Osservazioni
Questa struttura viene usata per contenere un descrittore di dispositivo usb definito dall'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-descrittore DALL.NET.
I iManufacturer, iProducte iSerialNumber valori, quando 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.
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione | usbspec.h (include Usb100.h) |