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_CAPABILITIEStipizzato.

Valore restituito

Nessuno

Osservazioni

Prima di tutto, la funzione WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT zero la struttura 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 IdleAllowUserControle imposta il membro Enabled su WdfUseDefault.

Inoltre, la funzione imposta il membro PowerUpIdleDeviceOnSystemWake su WdfUseDefault e sul 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 specifica IdleCannotWakeFromS0, la funzione imposta il membro DxState su PowerDeviceD3.

Esempi

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

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Universale
versione minima di KMDF	1.0
versione minima di UMDF	2.0
intestazione	wdfdevice.h (include Wdf.h)

Vedere anche

WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS