IWDFUsbTargetDevice：：RetrieveUsbInterface 方法 (wudfusb.h)

  • 项目

[警告： UMDF 2 是最新版本的 UMDF，取代了 UMDF 1。 所有新的 UMDF 驱动程序都应使用 UMDF 2 编写。 未向 UMDF 1 添加新功能，并且较新版本的 Windows 10 上对 UMDF 1 的支持有限。 通用 Windows 驱动程序必须使用 UMDF 2。 有关详细信息，请参阅使用 UMDF 入门。]

RetrieveUsbInterface 方法检索 USB 设备的指定 USB 接口。

语法

HRESULT RetrieveUsbInterface(
  [in]  UCHAR            InterfaceIndex,
  [out] IWDFUsbInterface **ppUsbInterface
);

参数

[in] InterfaceIndex

要检索的接口的索引。

[out] ppUsbInterface

指向变量的指针，该变量接收指向 USB 设备的指定 IWDFUsbInterface 接口的指针。

返回值

RetrieveUsbInterface 返回以下值之一：

返回代码 说明
S_OK

RetrieveUsbInterface 已成功检索 USB 设备的指定 USB 接口。
E_OUTOFMEMORY

RetrieveUsbInterface 遇到分配失败。
Winerror.h 中定义的错误代码
 此值对应于 WinUsb API 返回的错误代码。

注解

驱动程序可以调用 IWDFUsbTargetDevice：：GetNumInterfaces 方法来检索可用的 USB 接口总数。

驱动程序可以使用 RetrieveUsbInterface 检索的接口指针来调用 IWDFUsbInterface 接口提供的方法。 有关使用这些方法的详细信息，请参阅 在 UMDF 中使用 USB 接口。

示例

有关如何使用 RetrieveUsbInterface 方法的代码示例，请参阅 IWDFUsbTargetFactory：：CreateUsbTargetDevice。

要求

要求 值
结束支持 在 UMDF 2.0 及更高版本中不可用。
目标平台 桌面
最低 UMDF 版本 1.5
标头 wudfusb.h (包括 Wudfusb.h)
DLL WUDFx.dll

另请参阅

IWDFUsbInterface

IWDFUsbTargetDevice

IWDFUsbTargetDevice：：GetNumInterfaces

USBD_INTERFACE_INFORMATION