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

STATUS_RETRYで要求が失敗したときに、ドライバーが要求を再試行できる秒数を受け取る ULONG 変数へのポインター。

戻り値

操作が成功した場合は、STATUS_SUCCESSを返します。 それ以外の場合は、適切な NTSTATUS 値エラー コードを返します。 詳細については、「 NTSTATUS 値」を参照してください。 考えられるエラーは次のとおりです。

注釈

GUID_D3COLD_AUX_POWER_AND_TIMING_INTERFACE インターフェイスのクエリを正常に実行したデバイス ドライバーは 、D3COLD_AUX_POWER_AND_TIMING_INTERFACE 構造体へのポインターを受け取ります。この構造体では、ドライバーは RequestAuxPower メンバーを 、D3COLD_REQUEST_AUX_POWER コールバック関数の実装へのポインターに設定します。

• 多機能デバイスの場合、このルーチンを呼び出してデバイス全体の補助電源を設定するのは関数 0 のみです。

• 関数 0 は、このルーチンが呼び出されたときに D0 状態である必要があります。

• この要求が成功した後にコア電源レール電源が取り外される保証はありません。

要件