WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT-Funktion (wdfdevice.h)

[Gilt für KMDF und UMDF]

Die WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT-Funktion initialisiert die WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS Struktur eines Treibers.

Syntax

void WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT(
  [out] PWDF_DEVICE_POWER_POLICY_IDLE_SETTINGS Settings,
  [in]  WDF_POWER_POLICY_S0_IDLE_CAPABILITIES  IdleCaps
);

Parameter

[out] Settings

Ein Zeiger auf eine vom Treiber zugewiesene WDF_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 WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT-Funktion die angegebene WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS-Struktur auf Null und legt das Size-Element 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 und das IdleTimeoutType-Element auf DriverManagedIdleTimeoutout fest.

Darüber hinaus legt die Funktion 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.

Beispiele

Ein Codebeispiel, das WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT verwendet, finden Sie unter WdfDeviceAssignS0IdleSettings.

Anforderungen

Weitere Informationen

WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS