共用方式為

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 會傳回下列其中一個值：

傳回碼 Description
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