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

Confira também

Estruturas USB

UsbBuildGetDescriptorRequest

_URB_CONTROL_DESCRIPTOR_REQUEST