IWDFUsbTargetDevice：：RetrieveUsbInterface 方法 (wudfusb.h)

發行項
03/01/2024

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