USB_DEVICE_DESCRIPTOR結構 (usbspec.h)
USB 用戶端驅動程式會使用 USB_DEVICE_DESCRIPTOR 結構來擷取 USB 定義的裝置描述元。 此結構的成員會在 USB 文件庫提供的通用序列總線 3.1 規格中說明。 請參閱 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定義裝置描述元。 此資訊接著可用來進一步設定或擷取裝置的相關信息。 藉由提交 get-descriptor URB 來擷取裝置描述項。
從主機控制器驅動程式傳回時， iManufacturer、 iProduct 和 iSerialNumber 值會將索引值包含在裝置所維護的字串描述元陣列中。 若要擷取這些字串，可以使用這些索引值將字串描述元要求傳送至裝置。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 | usbspec.h (包含 Usb100.h) |