USB_DEVICE_DESCRIPTOR Struktur (usbspec.h)
Die USB_DEVICE_DESCRIPTOR-Struktur wird von USB-Clienttreibern verwendet, um einen USB-definierten Gerätedeskriptor abzurufen. Die Mitglieder dieser Struktur werden in der Spezifikation universal Serial Bus 3.1 beschrieben, die unter USB-Dokumentbibliothekverfügbar ist. Siehe Abschnitt 9.6.1.
Syntax
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;
Angehörige
bLength
Gibt die Länge dieses Deskriptors in Bytes an.
bDescriptorType
Gibt den Deskriptortyp an. Muss auf USB_DEVICE_DESCRIPTOR_TYPEfestgelegt sein.
bcdUSB
Gibt die Version der USB-Spezifikation an, der diese Deskriptorstruktur entspricht. Dieser Wert ist eine binärcodierte Dezimalzahl.
bDeviceClass
Gibt den Klassencode des Geräts an, wie es der USB-Spezifikationsgruppe zugewiesen ist.
bDeviceSubClass
Gibt den Unterklassencode des Geräts an, wie es der USB-Spezifikationsgruppe zugewiesen wurde.
bDeviceProtocol
Gibt den Protokollcode des Geräts an, der von der USB-Spezifikationsgruppe zugewiesen wird.
bMaxPacketSize0
Gibt die maximale Paketgröße in Bytes für Endpunkt 0 des Geräts an. Der Wert muss auf 8, 16, 32 oder 64 festgelegt werden.
idVendor
Gibt den Herstellerbezeichner für das Gerät an, wie es vom USB-Spezifikationsausschuss zugewiesen wurde.
idProduct
Gibt den Produktbezeichner an. Dieser Wert wird vom Hersteller zugewiesen und ist gerätespezifisch.
bcdDevice
Identifiziert die Version des Geräts. Dieser Wert ist eine binärcodierte Dezimalzahl.
iManufacturer
Gibt einen gerätedefinierten Index des Zeichenfolgendeskriptors an, der eine Zeichenfolge mit dem Namen des Herstellers dieses Geräts bereitstellt.
iProduct
Gibt einen gerätedefinierten Index des Zeichenfolgendeskriptors an, der eine Zeichenfolge enthält, die eine Beschreibung des Geräts enthält.
iSerialNumber
Gibt einen gerätedefinierten Index des Zeichenfolgendeskriptors an, der eine Zeichenfolge bereitstellt, die eine vom Hersteller festgelegte Seriennummer für das Gerät enthält.
bNumConfigurations
Gibt die Gesamtanzahl der möglichen Konfigurationen für das Gerät an.
Bemerkungen
Diese Struktur wird verwendet, um einen abgerufenen USB-definierten Gerätedeskriptor zu halten. Diese Informationen können dann verwendet werden, um Informationen zum Gerät weiter zu konfigurieren oder abzurufen. Gerätedeskriptoren werden abgerufen, indem sie eine GET-Deskriptor-URB übermitteln.
Die iManufacturer-, iProduct-und iSerialNumber- Werte enthalten, wenn sie vom Hostcontrollertreiber zurückgegeben werden, Indexwerte in einem Array von vom Gerät verwalteten Zeichenfolgendeskriptoren. Um diese Zeichenfolgen abzurufen, kann eine Zeichenfolgenbeschreibungsanforderung mithilfe dieser Indexwerte an das Gerät gesendet werden.
Anforderungen
Anforderung | Wert |
---|---|
Header- | usbspec.h (enthalten Usb100.h) |