WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT関数 (wudfdevice.h)
[警告: UMDF 2 は UMDF の最新バージョンであり、UMDF 1 よりも優先されます。 すべての新しい UMDF ドライバーは、UMDF 2 を使用して記述する必要があります。 UMDF 1 には新機能が追加されておらず、Windows 10 の新しいバージョンでは UMDF 1 のサポートが制限されています。 ユニバーサル Windows ドライバーでは、UMDF 2 を使用する必要があります。 詳細については、「UMDFの概要」を参照してください。
WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT 関数は、ドライバーの WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS 構造体を初期化します。
構文
void WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT(
[out] PWUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS Settings,
[in] WDF_POWER_POLICY_S0_IDLE_CAPABILITIES IdleCaps
);
パラメーター
[out] Settings
ドライバーによって割り当てられた WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS 構造体へのポインター。
[in] IdleCaps
WDF_POWER_POLICY_S0_IDLE_CAPABILITIES型指定された列挙子。
戻り値
何一つ
備考
まず、WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT 関数は、指定した WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS 構造体をゼロにし、構造体の Size メンバーを設定します。
次に、この関数は、構造体の IdleTimeout メンバーを IdleTimeoutDefaultValue に設定し、UserControlOfIdleSettings メンバーを IdleAllowUserControl に設定し、Enabled メンバーを WdfUseDefault に設定します。
さらに、この関数は、PowerUpIdleDeviceOnSystemWake メンバーを WdfUseDefault に設定します。
次に、ExcludeD3Cold メンバーを WdfUseDefault に設定します。
次に、この関数は、構造体の IdleCaps メンバーを、IdleCaps パラメーターが指定する値に設定します。
最後に、IdleCaps パラメーターが IdleUsbSelectiveSuspend または idleCanWakeFromS0 指定する場合、関数は、DxState メンバーを PowerDeviceMaximum 設定します。 IdleCaps パラメーター IdleCannotWakeFromS0を指定する場合、関数は、DxState メンバーを PowerDeviceD3 設定します。
WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INITを使用するコード例については、「IWDFDevice3::AssignS0IdleSettingsEx」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポート終了 | UMDF 2.0 以降では使用できません。 |
| ターゲット プラットフォーム の | デスクトップ |
| UMDF の最小バージョン を する | 1.11 |
| ヘッダー | wudfdevice.h |