IWDFUsbTargetDevice：：RetrieveUsbInterface 方法（wudfusb.h）

2025-02-07

[警告： 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