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) |