funzione WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT (wdfdevice.h)

[Si applica a KMDF e UMDF]

La funzione WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT inizializza la struttura di WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS di un driver.

Sintassi

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

Parametri

[out] Settings

Puntatore a una struttura di WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS allocata dal driver.

[in] IdleCaps

Enumeratore WDF_POWER_POLICY_S0_IDLE_CAPABILITIES tipizzato.

Valore restituito

nessuno

Osservazioni

Prima di tutto, la funzione WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT zero la struttura di WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS specificata e imposta il membro Size della struttura.

La funzione imposta quindi il membro IdleTimeout della struttura su IdleTimeoutDefaultValue, imposta il membro UserControlOfIdleSettings su IdleAllowUserControl e imposta il membro Abilitato su WdfUseDefault.

Inoltre, la funzione imposta il membro PowerUpIdleDeviceOnSystemWake su WdfUseDefault e il membro IdleTimeoutType su DriverManagedIdleTimeout.

Inoltre, la funzione imposta il membro ExcludeD3Cold su WdfUseDefault.

Successivamente, la funzione imposta il membro IdleCaps della struttura sul valore specificato dal parametro IdleCaps .

Infine, se il parametro IdleCaps specifica IdleUsbSelectiveSuspend o IdleCanWakeFromS0, la funzione imposta il membro DxState su PowerDeviceMaximum. Se il parametro IdleCaps specificaIdleCannotWakeFromS0, la funzione imposta il membro DxState su PowerDeviceD3.

Esempio

Per un esempio di codice che usa WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT, vedere WdfDeviceAssignS0IdleSettings.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Versione KMDF minima	1.0
Versione UMDF minima	2,0
Intestazione	wdfdevice.h (includere Wdf.h)

Vedi anche

WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS