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 を含む) |