次の方法で共有

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 値 を参照してください。 考えられるエラーは次のとおりです。

エラー コード 形容
STATUS_INVALID_PARAMETER 入力パラメーターが無効です。
STATUS_INVALID_DEVICE_REQUEST デバイスが D0 に含まれていないか、要求元が関数 0 ではありません。
STATUS_RETRY 要求が失敗し、システムは再試行が可能であることを示します。 RetryInSeconds には、ドライバーが次の要求を行う前に待機する秒数が含まれます。
STATUS_UNSUCCESSFUL 要求が失敗し、システムは現在要求された値が不可能であることを示します。
STATUS_SUCCESS 要求は成功しました。

備考

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

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

  • このルーチンを呼び出す場合、関数 0 は D0 状態である必要があります。

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

必要条件

要件 価値
サポートされる最小クライアント Windows 10 バージョン 1803
ヘッダー wdm.h (Wdm.h を含む)