共用方式為

IWDFUsbInterface：：RetrieveUsbPipeObject 方法 （wudfusb.h）

  • 發行項

[警告： UMDF 2 是最新版本的 UMDF，並取代 UMDF 1。 所有新的UMDF驅動程式都應該使用UMDF 2撰寫。 未將新功能新增至 UMDF 1，而且較新版本的 Windows 10 上對 UMDF 1 的支援有限。 通用 Windows 驅動程式必須使用 UMDF 2。 如需詳細資訊，請參閱 開始使用 UMDF。]

RetrieveUsbPipeObject 方法會擷取指定管道索引的 USB 管道物件。

語法

HRESULT RetrieveUsbPipeObject(
  [in]  UCHAR             PipeIndex,
  [out] IWDFUsbTargetPipe **ppPipe
);

參數

[in] PipeIndex

要擷取之USB管道物件的索引。

[out] ppPipe

變數的指標，該變數會接收 IWDFUsbTargetPipe 介面的指標，該介面是由 PipeIndex所指定索引的 USB 管道物件。

傳回值

RetrieveUsbPipeObject 會傳回下列其中一個值：

傳回碼 描述
S_OK

RetrieveUsbPipeObject 已成功擷取 USB 管道物件。
E_OUTOFMEMORY

RetrieveUsbPipeObject 發生配置失敗。
Winerror.h 中定義的錯誤碼
 此值對應於 WinUsb API 傳回的錯誤碼。

言論

UMDF 驅動程式可以呼叫 IWDFUsbTargetPipe 介面的方法，RetrieveUsbPipeObject 方法會擷取以取得管道類型和其他資訊。

例子

如需如何使用RetrieveUsbPipeObject 方法的程式代碼範例，請參閱 IWDFUsbInterface：：GetNumEndPoints。

要求

要求 價值
終止支援 UMDF 2.0 和更新版本中無法使用。
目標平臺 桌面
最低 UMDF 版本 1.5
標頭 wudfusb.h （包括 Wudfusb.h）
DLL WUDFx.dll

另請參閱

IWDFUsbInterface

IWDFUsbTargetPipe