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. Es werden keine neuen Features zu UMDF 1 hinzugefügt, und es gibt eingeschränkte Unterstützung für UMDF 1 für neuere Versionen von Windows 10. 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-typed-Enumerator.
Rückgabewert
Nichts
Bemerkungen
Zunächst stellt die WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT-Funktion die angegebene WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS Struktur null und legt das Size-Element der Struktur fest.
Anschließend legt die Funktion die IdleTimeout Member der Struktur auf IdleTimeoutDefaultValue-fest, legt den UserControlOfIdleSettings Member auf IdleAllowUserControlfest und legt den Enabled Member auf WdfUseDefaultfest.
Darüber hinaus legt die Funktion den PowerUpIdleDeviceOnSystemWake Member auf WdfUseDefault-fest.
Anschließend legt die Funktion den ExcludeD3Cold Member auf WdfUseDefault-fest.
Als Nächstes legt die Funktion die IdleCaps Element der Struktur auf den Wert fest, den der IdleCaps Parameter angibt.
Wenn der parameter IdleCaps schließlich IdleUsbSelectiveSuspend oder IdleCanWakeFromS0angibt, legt die Funktion den DxState Member auf PowerDeviceMaximumfest. Wenn der parameter IdleCapsIdleCannotWakeFromS0angibt, legt die Funktion den DxState Member auf PowerDeviceD3fest.
Ein Codebeispiel, das WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INITverwendet, finden Sie unter IWDFDevice3::AssignS0IdleSettingsEx.
Anforderungen
| Anforderung | Wert |
|---|---|
| Ende des Supports | In UMDF 2.0 und höher nicht verfügbar. |
| Zielplattform- | Desktop |
| Mindest-UMDF-Version | 1.11 |
| Header- | wudfdevice.h |