標準USB描述元
USB 裝置會在稱為 USB 描述元的數據結構中提供本身的相關信息。 本節提供裝置、設定、介面和端點描述元的相關信息，以及從USB裝置擷取它們的方式。
對應至裝置配置的 USB 描述元
主機軟體會透過將各種標準控制要求傳送至預設端點， (取得描述元要求，以從連結裝置取得描述項，請參閱 USB 規格第 9.4.3 節) 。 這些要求會指定要擷取的描述符類型。 為了回應這類要求，裝置會傳送描述項，其中包含裝置的相關信息、其設定、介面和相關端點。 裝置描述項 包含整個裝置的相關信息。 組態描述項 包含每個裝置設定的相關信息。 字串描述元 包含 Unicode 文字字串。
每個USB裝置都會公開裝置描述項，指出裝置的類別資訊、廠商和產品標識元，以及組態數目。 每個組態都會公開其組態描述元，指出介面數目和電源特性。 每個介面都會針對每個介面的替代設定公開介面描述元，其中包含類別和端點數目的相關信息。 每個介面內的每個端點都會公開端點描述元，指出端點類型和封包大小上限。
例如，讓我們考慮 OSR FX2 面板裝置配置 (請參閱 USB 裝置配置) 。 在裝置層級，裝置會公開裝置描述項和預設端點的端點描述元。 在組態層級，裝置會公開 Configuration 0 的組態描述元。 在介面層級，它會公開替代設定0的一個介面描述元。 在端點層級，它會公開三個端點描述元。
USB 裝置描述元
每個通用序列總線 (USB) 裝置都必須能夠提供包含裝置相關信息的單一裝置描述元。 Windows 會使用該資訊來衍生各種資訊集。 例如， idVendor 和 idProduct 字段分別指定廠商和產品識別碼。 Windows 會使用這些域值來建構裝置的硬體標識碼。 若要檢視特定裝置的硬體標識碼，請開啟 裝置管理員 並檢視裝置屬性。 在 [ 詳細數據 ] 索引標籤中， [硬體 標識符] 屬性值會指出 Windows 產生的硬體標識碼 (“USB\XXX”) 。 bcdUSB 欄位指出裝置符合的 USB 規格版本。 例如，0x0200表示裝置是根據USB 2.0規格所設計。 bcdDevice 值表示裝置定義的修訂編號。 USB 驅動程式堆疊會使用 bcdDevice 以及 idVendor 和 idProduct 來產生裝置的硬體和相容標識碼。 您可以在 裝置管理員 中檢視這些識別碼。 裝置描述項也會指出裝置支援的組態總數。
主機會透過控制傳輸取得裝置描述項。 Microsoft 提供程式設計介面來取得描述元。
| 如果您要撰寫... | 叫。。。 |
|---|---|
| 使用 Windows.Devices.Usb 的 UWP 應用程式 | UsbDevice.DeviceDescriptor |
| 使用 WinUSB 函式的 Win32 傳統型應用程式 | WinUsb_GetDescriptor |
| UMDF 型用戶端驅動程式 | IWDFUsbTargetDevice：：RetrieveDescriptor |
| KMDF 型用戶端驅動程式 | WdfUsbTargetDeviceGetDeviceDescriptor |
| WDM 型用戶端驅動程式 | UsbBuildGetDescriptorRequest _URB_CONTROL_DESCRIPTOR_REQUEST |
USB 組態描述元
USB 組態包含一系列介面。 每個介面都包含一或多個替代設定，而每個替代設定是由一組端點所組成， (請參閱 USB 裝置配置) 。 組態描述項描述整個組態包括其介面、替代設定及其端點。 每個實體也會以其描述項格式加以描述。 組態描述元也可以包含裝置製造商所定義的自定義描述元。
因此，只有組態描述元的初始部分是固定的，9 個字節。 其餘部分取決於介面數目及其替代設定，以及裝置支援的端點。 在此檔集中，初始 9 個字節稱為組態描述元。 描述元的前兩個字節表示總長度。
下表顯示 USB 網路攝影機裝置的組態描述元：
| 欄位 | 值 |
|---|---|
| wTotalLength | 0x02CA |
| bNumInterfaces | 0x02 |
| bConfigurationValue | 0x01 |
| iConfiguration | 0x00 |
| bmAttributes | 0x80 (总线 ) |
| MaxPower | 0xFA (500 mA) |
bConfigurationValue 字段會指出裝置韌體中定義的組態數目。 USB 組態也會指出特定電源特性。 bmAttributes 包含位掩碼，指出組態是否支援遠端喚醒功能，以及裝置是否為總線電源或自我電源。 MaxPower 欄位會指定裝置在總線電源時，裝置可從主機繪製的最大電源 () 。 組態描述元也會指出裝置支援 (bNumInterfaces) 介面總數。
| 如果您要撰寫... | 叫。。。 |
|---|---|
| 使用 Windows.Devices.Usb 的 UWP 應用程式 | UsbDevice.ConfigurationDescriptor 可取得固定長度部分。 UsbConfiguration.Descriptors 可取得整個組態集。 |
| 使用 WinUSB 函式的 Win32 傳統型應用程式 | WinUsb_GetDescriptor |
| UMDF 型用戶端驅動程式 | IWDFUsbTargetDevice：：RetrieveDescriptor |
| KMDF 型用戶端驅動程式 | WdfUsbTargetDeviceRetrieveConfigDescriptor |
| WDM 型用戶端驅動程式 | UsbBuildGetDescriptorRequest _URB_CONTROL_GET_CONFIGURATION_REQUEST |
USB 介面描述元
介面描述元包含 USB 介面的替代設定相關信息。
下表顯示網路攝影機裝置之替代設定 0 的介面描述元：
| 欄位 | 值 |
|---|---|
| bInterfaceNumber | 0x00 |
| bAlternateSetting | 0x00 |
| bNumEndpoints | 0x01 |
| bInterfaceClass | 0x0E |
| bInterfaceSubClass | 0x02 |
| bInterfaceProtocol | 0x00 |
| iInterface | 0x02 |
| 0x0409 | “Microsoft LifeCam VX-5000” |
| 0x0409 | “Microsoft LifeCam VX-5000” |
在上述範例中，請注意 bInterfaceNumber 和 bAlternateSetting 域值。 這些欄位包含主機用來啟動介面及其其中一個替代設定的索引值。 針對啟用，應用程式或驅動程式會在函數調用中指定索引值。 根據該資訊，USB 驅動程式堆疊接著會建置標準控制要求 (SET INTERFACE) ，並將其傳送至裝置。 請注意 bInterfaceClass 欄位。 任何替代設定的介面描述元或描述項會指定類別程式代碼、子類別和通訊協定。 0x0E的值表示介面適用於視訊裝置類別。 此外，請注意 iInterface 欄位。 該值表示有兩個字串描述元附加至介面描述元。 字串描述項包含 Unicode 描述，這些描述會在裝置列舉期間用來識別功能。
| 如果您要撰寫... | 叫。。。 |
|---|---|
| 使用 Windows.Devices.Usb 的 UWP 應用程式 | UsbInterfaceSetting.Descriptors 可取得特定替代設定的特定描述元。 UsbInterface.Descriptors 可取得介面所有設定的描述項。 |
| 使用 WinUSB 函式的 Win32 傳統型應用程式 | WinUsb_GetDescriptor |
| UMDF 型用戶端驅動程式 | IWDFUsbInterface：：GetInterfaceDescriptor |
| KMDF 型用戶端驅動程式 | WdfUsbInterfaceGetDescriptor |
| 以 WDM 為基礎的用戶端驅動程式 | UsbBuildGetDescriptorRequest _URB_CONTROL_GET_CONFIGURATION_REQUEST ，然後剖析每個介面描述元。 如需詳細資訊，請參閱 如何選取USB裝置的設定。 |
USB 端點描述元
介面中的每個端點都會描述裝置的單一輸入或輸出數據流。 支援不同函式數據流的裝置有多個介面。 支持數個與函式相關數據流的裝置，可以在單一介面上支援多個端點。
除了預設端點) 以外，所有端點類型 (都必須提供端點描述項，讓主機可以取得端點的相關信息。 端點描述項包含資訊，例如其位址、類型、方向，以及端點可處理的數據量。 傳送至端點的數據是以該資訊為基礎。
下表顯示網路攝影機裝置的端點描述項：
| 欄位 | 值 |
|---|---|
| bEndpointAddress | 0x82 IN |
| bmAttributes | 0x01 |
| wMaxPacketSize | 0x0080 (128) |
| bInterval | 0x01 |
bEndpointAddress 字段會指定唯一的端點位址，其中包含端點號碼 (Bits 3..0) ，以及端點方向 (位 7) 。 藉由讀取上述範例中的這些值，我們可以判斷描述元描述其端點編號為 2 的 IN 端點。 bmAttributes 屬性表示端點類型為等時。 wMaxPacketSizefield 指出端點可以在單一交易中傳送或接收的最大位元組數目。 位12..11表示每個微框架可傳送的交易總數。 bInterval 指出端點可以傳送或接收數據的頻率。
| 如果您要撰寫... | 叫。。。 |
|---|---|
| 使用 Windows.Devices.Usb 的 UWP 應用程式 | UsbEndpointDescriptor |
| 使用 WinUSB 函式的 Win32 傳統型應用程式 | WinUsb_GetDescriptor |
| UMDF 型用戶端驅動程式 | WDFUsbTargetPipe：：GetInformation |
| KMDF 型用戶端驅動程式 | WdfUsbTargetPipeGetInformation |
| 以 WDM 為基礎的用戶端驅動程式 | UsbBuildGetDescriptorRequest _URB_CONTROL_GET_CONFIGURATION_REQUEST ，然後剖析每個端點描述元。 如需詳細資訊，請參閱 如何選取USB裝置的設定。 |