使用 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 接口中选择备用设置