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 返回以下值之一：
| 返回代码 | 说明 |
|---|---|
|
RetrieveUsbInterface 已成功检索 USB 设备的指定 USB 接口。 |
|
RetrieveUsbInterface 遇到分配失败。 |
|
此值对应于 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 |