次の方法で共有

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

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

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

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

要件

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