WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT関数 (wdfdevice.h)
[KMDF と UMDF に適用]
WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT 関数は、ドライバーの WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS 構造体を初期化します。
構文
void WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT(
[out] PWDF_DEVICE_POWER_POLICY_IDLE_SETTINGS Settings,
[in] WDF_POWER_POLICY_S0_IDLE_CAPABILITIES IdleCaps
);
パラメーター
[out] Settings
ドライバーによって割り当てられた WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS 構造体へのポインター。
[in] IdleCaps
WDF_POWER_POLICY_S0_IDLE_CAPABILITIES型指定された列挙子。
戻り値
何一つ
備考
最初に、WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT 関数は、指定した WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS 構造体をゼロにし、構造体の Size メンバーを設定します。
次に、この関数は、構造体の IdleTimeout メンバーを IdleTimeoutDefaultValue に設定し、UserControlOfIdleSettings メンバーを IdleAllowUserControl に設定し、Enabled メンバーを WdfUseDefault に設定します。
さらに、この関数は、PowerUpIdleDeviceOnSystemWake メンバーを WdfUseDefault 、IdleTimeoutType メンバーを DriverManagedIdleTimeout に設定します。
さらに、この関数は、ExcludeD3Cold メンバーを WdfUseDefault 設定します。
次に、この関数は、構造体の IdleCaps メンバーを、IdleCaps パラメーターが指定する値に設定します。
最後に、IdleCaps パラメーターが IdleUsbSelectiveSuspend または idleCanWakeFromS0 指定する場合、関数は、DxState メンバーを PowerDeviceMaximum 設定します。 IdleCaps パラメーター IdleCannotWakeFromS0を指定する場合、関数は、DxState メンバーを PowerDeviceD3 設定します。
例
WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INITを使用するコード例については、「WdfDeviceAssignS0IdleSettingsを参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | 万国 |
| 最小 KMDF バージョン | 1.0 |
| UMDF の最小バージョン を する | 2.0 |
| ヘッダー | wdfdevice.h (Wdf.h を含む) |