共用方式為

IWDFUsbTargetDevice：：SetPowerPolicy 方法 (wudfusb.h)

  • 發行項

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

SetPowerPolicy 方法會設定 WinUsb 電源原則。

語法

HRESULT SetPowerPolicy(
  [in] ULONG PolicyType,
  [in] ULONG ValueLength,
  [in] PVOID Value
);

參數

[in] PolicyType

UMDF 驅動程式設定的 WinUsb 電源原則類型。

[in] ValueLength

SetPowerPolicy 在 Value 中提供的緩衝區大小，以位元組為單位。

[in] Value

包含 WinUsb 電源原則之緩衝區的指標。

傳回值

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

傳回碼 Description
S_OK

SetPowerPolicy 已成功設定 WinUsb 電源原則。
E_OUTOFMEMORY

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

備註

電源原則可控制 WinUsb 用於裝置執行的電源管理。

如需 UMDF 驅動程式可以針對 PolicyType 和 Value 參數傳遞之有效原則類型和值的相關信息，請參閱 WinUsb_SetPowerPolicy 函式。

如需 WinUSB 電源行為的詳細資訊，請參閱 WinUSB 電源管理。

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

規格需求

需求 值
終止支援 UMDF 2.0 和更新版本中無法使用。
目標平台 桌面
最低UMDF版本 1.5
標頭 wudfusb.h (包括 Wudfusb.h)
Dll WUDFx.dll

另請參閱

IWDFUsbTargetDevice

IWDFUsbTargetDevice：：RetrievePowerPolicy

WinUsb_SetPowerPolicy