WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT-Funktion (wudfdevice.h)

  • Artikel

[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

Weitere Informationen

IWDFDevice3::AssignS0IdleSettingsEx

WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS