struktur USB_DEVICE_DESCRIPTOR (usbspec.h)

Struktur USB_DEVICE_DESCRIPTOR digunakan oleh driver klien USB untuk mengambil deskriptor perangkat yang ditentukan USB. Anggota struktur ini dijelaskan dalam Spesifikasi Universal Serial Bus 3.1 yang tersedia di USB Document Library. Lihat bagian 9.6.1.

Sintaks

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;

Anggota

bLength

Menentukan panjang, dalam byte, dari deskriptor ini.

bDescriptorType

Menentukan jenis deskriptor. Harus diatur ke USB_DEVICE_DESCRIPTOR_TYPE.

bcdUSB

Mengidentifikasi versi spesifikasi USB yang mematuhi struktur deskriptor ini. Nilai ini adalah angka desimal berkode biner.

bDeviceClass

Menentukan kode kelas perangkat seperti yang ditetapkan oleh grup spesifikasi USB.

bDeviceSubClass

Menentukan kode subkelas perangkat seperti yang ditetapkan oleh grup spesifikasi USB.

bDeviceProtocol

Menentukan kode protokol perangkat seperti yang ditetapkan oleh grup spesifikasi USB.

bMaxPacketSize0

Menentukan ukuran paket maksimum, dalam byte, untuk titik akhir nol perangkat. Nilai harus diatur ke 8, 16, 32, atau 64.

idVendor

Menentukan pengidentifikasi vendor untuk perangkat seperti yang ditetapkan oleh komite spesifikasi USB.

idProduct

Menentukan pengidentifikasi produk. Nilai ini ditetapkan oleh produsen dan khusus untuk perangkat.

bcdDevice

Mengidentifikasi versi perangkat. Nilai ini adalah angka desimal berkode biner.

iManufacturer

Menentukan indeks deskriptor string yang ditentukan perangkat yang menyediakan string yang berisi nama produsen perangkat ini.

iProduct

Menentukan indeks deskriptor string yang ditentukan perangkat yang menyediakan string yang berisi deskripsi perangkat.

iSerialNumber

Menentukan indeks deskriptor string yang ditentukan perangkat yang menyediakan string yang berisi nomor seri yang ditentukan produsen untuk perangkat.

bNumConfigurations

Menentukan jumlah total konfigurasi yang mungkin untuk perangkat.

Keterangan

Struktur ini digunakan untuk menahan deskriptor perangkat yang ditentukan USB yang diambil. Informasi ini kemudian dapat digunakan untuk mengonfigurasi atau mengambil informasi lebih lanjut tentang perangkat. Deskriptor perangkat diambil dengan mengirimkan URB get-descriptor.

Nilai iManufacturer, iProduct, dan iSerialNumber , ketika dikembalikan dari driver pengontrol host, berisi nilai indeks ke dalam array deskriptor string yang dikelola oleh perangkat. Untuk mengambil string ini, permintaan deskriptor string dapat dikirim ke perangkat menggunakan nilai indeks ini.

Persyaratan

Persyaratan	Nilai
Header	usbspec.h (termasuk Usb100.h)

Lihat juga

Struktur USB

UsbBuildGetDescriptorRequest

_URB_CONTROL_DESCRIPTOR_REQUEST