共用方式為

IWDFUsbTargetPipe：：RetrievePipePolicy 方法 （wudfusb.h）

  • 發行項

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

RetrievePipePolicy 方法會擷取 WinUsb 管道原則。

語法

HRESULT RetrievePipePolicy(
  [in]      ULONG PolicyType,
  [in, out] ULONG *ValueLength,
  [out]     PVOID Value
);

參數

[in] PolicyType

UMDF 驅動程式要求的 WinUsb 管道原則類型。

[in, out] ValueLength

輸入上變數的指標，包含 RetrievePipePolicyValue提供之緩衝區的大小，以位元組為單位。 在輸出時，此參數包含 RetrievePipePolicyValue所需的大小。

[out] Value

接收包含 WinUsb 管道原則之緩衝區的指標。

傳回值

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

傳回碼 描述
S_OK

RetrievePipePolicy 已成功擷取 WinUsb 管道原則。
E_OUTOFMEMORY

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

言論

管道原則會控制 USB 管道的行為（例如逾時、處理短封包等等）。

如需 UMDF 驅動程式可以針對架構傳回之 PolicyType 參數和值傳遞之有效原則類型的詳細資訊，請參閱 WinUsb_GetPipePolicy 函式。

如需管道原則行為的相關信息，請參閱 用於管道原則修改的 WinUSB 函式。

RetrievePipePolicy 方法會產生 UMDF 要求，並以同步方式將要求傳送至 I/O 目標。

要求

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

另請參閱

IWDFUsbTargetPipe

IWDFUsbTargetPipe：：SetPipePolicy

WinUsb_GetPipePolicy