WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT-Funktion (wudfdevice.h)
[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. UMDF 1 werden keine neuen Features hinzugefügt, und die Unterstützung für UMDF 1 für neuere Versionen von Windows 10 ist eingeschränkt. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF.]
Die WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT-Funktion initialisiert die WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS Struktur eines Treibers.
Syntax
void WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT(
[out] PWUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS Settings,
[in] WDF_POWER_POLICY_S0_IDLE_CAPABILITIES IdleCaps
);
Parameter
[out] Settings
Ein Zeiger auf eine vom Treiber zugewiesene WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS-Struktur .
[in] IdleCaps
Ein WDF_POWER_POLICY_S0_IDLE_CAPABILITIES typisierter Enumerator.
Rückgabewert
Keine
Bemerkungen
Zunächst stellt die WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT-Funktion die angegebene WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS-Struktur auf Null und legt das Element Size der Struktur fest.
Anschließend legt die Funktion den IdleTimeout-Member der Struktur auf IdleTimeoutDefaultValue fest, legt den UserControlOfIdleSettings-Member auf IdleAllowUserControl fest und legt das Enabled-Element auf WdfUseDefault fest.
Darüber hinaus legt die Funktion das PowerUpIdleDeviceOnSystemWake-Element auf WdfUseDefault fest.
Die Funktion legt dann das ExcludeD3Cold-Element auf WdfUseDefault fest.
Als Nächstes legt die Funktion den IdleCaps-Member der Struktur auf den Wert fest, den der IdleCaps-Parameter angibt.
Wenn schließlich der IdleCaps-ParameterIdleUsbSelectiveSuspend oder IdleCanWakeFromS0 angibt, legt die Funktion den DxState-Member auf PowerDeviceMaximum fest. Wenn der IdleCaps-ParameterIdleCannotWakeFromS0 angibt, legt die Funktion den DxState-Member auf PowerDeviceD3 fest.
Ein Codebeispiel, das WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT verwendet, finden Sie unter IWDFDevice3::AssignS0IdleSettingsEx.
Anforderungen
| Anforderung | Wert |
|---|---|
| Ende des Supports | In UMDF 2.0 und höher nicht verfügbar. |
| Zielplattform | Desktop |
| UMDF-Mindestversion | 1.11 |
| Kopfzeile | wudfdevice.h |