estrutura USB_DEVICE_DESCRIPTOR (usbspec.h)
A estrutura USB_DEVICE_DESCRIPTOR é usada por drivers de cliente USB para recuperar um descritor de dispositivo definido por USB. Os membros dessa estrutura são descritos na Especificação do Barramento Serial Universal 3.1 disponível na Biblioteca de Documentos USB. Consulte a seção 9.6.1.
Sintaxe
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;
Membros
bLength
Especifica o comprimento, em bytes, desse descritor.
bDescriptorType
Especifica o tipo de descritor. Deve ser definido como USB_DEVICE_DESCRIPTOR_TYPE.
bcdUSB
Identifica a versão da especificação USB com a qual essa estrutura de descritor está em conformidade. Esse valor é um número decimal codificado em binário.
bDeviceClass
Especifica o código de classe do dispositivo conforme atribuído pelo grupo de especificações USB.
bDeviceSubClass
Especifica o código de subclasse do dispositivo conforme atribuído pelo grupo de especificações USB.
bDeviceProtocol
Especifica o código de protocolo do dispositivo conforme atribuído pelo grupo de especificações USB.
bMaxPacketSize0
Especifica o tamanho máximo do pacote, em bytes, para o ponto de extremidade zero do dispositivo. O valor deve ser definido como 8, 16, 32 ou 64.
idVendor
Especifica o identificador do fornecedor para o dispositivo conforme atribuído pelo comitê de especificação USB.
idProduct
Especifica o identificador do produto. Esse valor é atribuído pelo fabricante e é específico do dispositivo.
bcdDevice
Identifica a versão do dispositivo. Esse valor é um número decimal codificado em binário.
iManufacturer
Especifica um índice definido pelo dispositivo do descritor de cadeia de caracteres que fornece uma cadeia de caracteres que contém o nome do fabricante deste dispositivo.
iProduct
Especifica um índice definido pelo dispositivo do descritor de cadeia de caracteres que fornece uma cadeia de caracteres que contém uma descrição do dispositivo.
iSerialNumber
Especifica um índice definido pelo dispositivo do descritor de cadeia de caracteres que fornece uma cadeia de caracteres que contém um número de série determinado pelo fabricante para o dispositivo.
bNumConfigurations
Especifica o número total de configurações possíveis para o dispositivo.
Comentários
Essa estrutura é usada para conter um descritor de dispositivo definido por USB recuperado. Essas informações podem ser usadas para configurar ou recuperar informações sobre o dispositivo. Os descritores de dispositivo são recuperados enviando um URB get-descriptor.
Os valores iManufacturer, iProduct e iSerialNumber , quando retornados do driver do controlador de host, contêm valores de índice em uma matriz de descritores de cadeia de caracteres mantida pelo dispositivo. Para recuperar essas cadeias de caracteres, uma solicitação de descritor de cadeia de caracteres pode ser enviada ao dispositivo usando esses valores de índice.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | usbspec.h (inclua Usb100.h) |