funzione WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT (wudfdevice.h)
[Avviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Nessuna nuova funzionalità viene aggiunta a UMDF 1 ed è disponibile un supporto limitato per UMDF 1 nelle versioni più recenti di Windows 10. I driver di Windows universali devono usare UMDF 2. Per altre informazioni, vedere Introduzione con UMDF.]
La funzione WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT inizializza la struttura di WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS di un driver.
Sintassi
void WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT(
[out] PWUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS Settings,
[in] WDF_POWER_POLICY_S0_IDLE_CAPABILITIES IdleCaps
);
Parametri
[out] Settings
Puntatore a una struttura di WUDF_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 WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT zero la struttura di WUDF_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.
La funzione imposta quindi 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.
Per un esempio di codice che usa WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT, vedere IWDFDevice3::AssignS0IdleSettingsEx.
Requisiti
| Requisito | Valore |
|---|---|
| Fine del supporto | Non disponibile in UMDF 2.0 e versioni successive. |
| Piattaforma di destinazione | Desktop |
| Versione UMDF minima | 1.11 |
| Intestazione | wudfdevice.h |