D3COLD_REQUEST_AUX_POWER回呼函式 (wdm.h)

  • 發行項

讓函式裝置物件 (FDO) 傳達其輔助電源需求。

語法

D3COLD_REQUEST_AUX_POWER D3coldRequestAuxPower;

NTSTATUS D3coldRequestAuxPower(
  [_In_reads_opt_(_Inexpressible_("varies"))] PVOID Context,
  [_In_]                                      ULONG AuxPowerInMilliWatts,
  [_Out_]                                     PULONG RetryInSeconds
)
{...}

參數

Context

裝置的句柄。

[_In_] AuxPowerInMilliWatts

當系統位於 S0 時，裝置需要 D3cold 的單位 mW。 此值必須小於 0x80000000。

[_Out_] RetryInSeconds

ULONG 變數的指標，可接收驅動程式在要求失敗且STATUS_RETRY時重試其要求數。

傳回值

如果作業成功，則傳回STATUS_SUCCESS。 否則，傳回適當的NTSTATUS值錯誤碼。 如需詳細資訊，請參閱 NTSTATUS值。 可能的錯誤如下所示：

錯誤碼 描述
STATUS_INVALID_PARAMETER 輸入參數無效。
STATUS_INVALID_DEVICE_REQUEST 裝置不在 D0 中，或要求者不是函式 0。
STATUS_RETRY 要求失敗，而且系統表示可以重試。 RetryInSeconds 將包含驅動程式在提出下一個要求之前應該等候的秒數。
STATUS_UNSUCCESSFUL 要求失敗，而且系統表示目前的要求值無法執行。
STATUS_SUCCESS 要求成功。

備註

成功查詢GUID_D3COLD_AUX_POWER_AND_TIMING_INTERFACE介面的裝置驅動程式會接收 D3COLD_AUX_POWER_AND_TIMING_INTERFACE 結構的指標，其中驅動程式會將 RequestAuxPower 成員設定為其 D3COLD_REQUEST_AUX_POWER 回呼函式實作的指標。

  • 對於多函式裝置，只有 Function 0 預期會呼叫此例程，並設定整個裝置的輔助電源。

  • 呼叫此例程時，函式 0 必須處於 D0 狀態。

  • 不保證在此要求成功之後，將會移除核心電源軌電源。

規格需求

需求 值
最低支援的用戶端 Windows 10 (版本 1803)
標頭 wdm.h (包含 Wdm.h)