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) |