структура USB_DEVICE_DESCRIPTOR (usbspec.h)
Структура USB_DEVICE_DESCRIPTOR используется драйверами USB-клиента для получения дескриптора устройства, определяемого USB. Члены этой структуры описаны в спецификации универсальной последовательной шины 3.1, доступной в библиотеке документов USB. См. раздел 9.6.1.
Синтаксис
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;
Члены
bLength
Указывает длину дескриптора в байтах.
bDescriptorType
Указывает тип дескриптора. Необходимо задать значение USB_DEVICE_DESCRIPTOR_TYPE.
bcdUSB
Определяет версию спецификации USB, которая соответствует этой структуре дескриптора. Это значение представляет собой закодированное двоичное десятичное число.
bDeviceClass
Задает код класса устройства, назначенный группой спецификаций USB.
bDeviceSubClass
Указывает код подкласса устройства, назначенного группой спецификаций USB.
bDeviceProtocol
Указывает код протокола устройства, назначенный группой спецификаций USB.
bMaxPacketSize0
Указывает максимальный размер пакета (в байтах) для конечной точки ноль устройства. Значение должно иметь значение 8, 16, 32 или 64.
idVendor
Указывает идентификатор поставщика для устройства, назначенного комитетом спецификации USB.
idProduct
Указывает идентификатор продукта. Это значение назначается производителем и зависит от устройства.
bcdDevice
Определяет версию устройства. Это значение представляет собой закодированное двоичное десятичное число.
iManufacturer
Задает определяемый устройством индекс дескриптора строки, предоставляющий строку, содержащую имя производителя этого устройства.
iProduct
Задает определяемый устройством индекс дескриптора строки, предоставляющий строку, содержащую описание устройства.
iSerialNumber
Указывает определяемый устройством индекс дескриптора строки, предоставляющий строку, содержащую серийный номер, определяемый производителем для устройства.
bNumConfigurations
Указывает общее количество возможных конфигураций для устройства.
Замечания
Эта структура используется для хранения извлеченного дескриптора устройства, определяемого USB. Затем эти сведения можно использовать для дальнейшей настройки или получения сведений об устройстве. Дескрипторы устройств извлекаются путем отправки URB-дескриптора get-descriptor.
iManufacturer, iProductи значения iSerialNumber, возвращаемые драйвером контроллера узла, содержат значения индекса в массив дескрипторов строк, поддерживаемых устройством. Чтобы получить эти строки, запрос дескриптора строки можно отправить на устройство с помощью этих значений индекса.
Требования
| Требование | Ценность |
|---|---|
| заголовка | usbspec.h (include Usb100.h) |