共用方式為


使用 USB 介面

架構會將每個 USB 介面表示為 架構 USB 介面物件。 當驅動程式 建立架構 USB 裝置物件時,架構會針對裝置第一個 USB 組態所包含的每個 USB 介面建立架構 USB 介面物件。

大部分的 USB 裝置只有一個介面,而且介面只有一個替代設定。 這類裝置的驅動程式通常不需要使用架構的 USB 介面物件所定義的物件方法。

如果您的驅動程式支援提供多個介面或替代設定的 USB 裝置,介面物件方法可讓驅動程式執行下列作業:

取得介面資訊

在驅動程式呼叫 WdfUsbTargetDeviceCreateWithParameters之後,它可以呼叫 WdfUsbTargetDeviceGetInterface ,以取得代表其中一個裝置 USB 介面之架構 USB 介面物件的控制碼。 然後,您的驅動程式可以呼叫 USB 介面物件所定義的數種方法,以取得 USB 介面的相關資訊。

您的驅動程式可以在呼叫 WdfUsbTargetDeviceCreateWithParameters之後隨時呼叫下列方法:

WdfUsbInterfaceGetInterfaceNumber
傳回與 USB 介面物件相關聯的 USB 介面編號。

WdfUsbInterfaceGetDescriptor
擷取與其中一個 USB 介面替代設定相關聯的 USB 介面描述元。

WdfUsbInterfaceGetNumEndpoints
傳回與 USB 介面其中一個替代設定相關聯的端點數目。

WdfUsbInterfaceGetEndpointInformation
擷取端點及其相關聯管道的相關資訊。

您的驅動程式可以在呼叫 WdfUsbTargetDeviceSelectConfig之後呼叫下列方法:

WdfUsbInterfaceGetConfiguredSettingIndex
傳回索引值,識別目前為 USB 介面選取的替代設定。

WdfUsbInterfaceGetNumConfiguredPipes
傳回為指定的 USB 裝置介面設定的管道數目。

WdfUsbInterfaceGetConfiguredPipe
傳回與指定之 USB 裝置介面和管道索引相關聯的架構管道物件的控制碼。

選取 USB 介面的替代設定

在驅動程式呼叫 WdfUsbTargetDeviceCreateWithParameters之後,驅動程式可以呼叫 WdfUsbInterfaceGetNumSettings 來取得 USB 介面支援的替代設定數目。

在驅動程式呼叫 WdfUsbTargetDeviceSelectConfig 以選取 USB 裝置的設定之後,驅動程式可以呼叫 WdfUsbInterfaceSelectSetting 來選取其中一個組態 USB 介面的替代設定。

裝置的替代設定必須連續編號,從零開始。

如需相關資訊,請參閱 如何在 USB 介面中選取替代設定