fonction WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT (wdfdevice.h)
[S’applique à KMDF et UMDF]
La fonction WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT initialise la structure WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS d’un pilote.
Syntaxe
void WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT(
[out] PWDF_DEVICE_POWER_POLICY_IDLE_SETTINGS Settings,
[in] WDF_POWER_POLICY_S0_IDLE_CAPABILITIES IdleCaps
);
Paramètres
[out] Settings
Pointeur vers une structure de WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS allouée par le pilote.
[in] IdleCaps
Énumérateur de type WDF_POWER_POLICY_S0_IDLE_CAPABILITIES.
Valeur de retour
None
Remarques
Tout d’abord, la fonction WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT zéro la structure WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS spécifiée et définit le membre Size de la structure.
Ensuite, la fonction définit le membre IdleTimeout de la structure sur IdleTimeoutDefaultValue, définit le membre UserControlOfIdleSettings sur IdleAllowUserControl et définit le membre Enabled sur WdfUseDefault.
En outre, la fonction définit le membre PowerUpIdleDeviceOnSystemWake sur WdfUseDefault et le membre IdleTimeoutType sur DriverManagedIdleTimeout.
En outre, la fonction définit le membre ExcludeD3Cold sur WdfUseDefault.
Ensuite, la fonction définit le membre IdleCaps de la structure sur la valeur spécifiée par le paramètre IdleCaps .
Enfin, si le paramètre IdleCaps spécifie IdleUsbSelectiveSuspend ou IdleCanWakeFromS0, la fonction définit le membre DxState sur PowerDeviceMaximum. Si le paramètre IdleCaps spécifie IdleCannotWakeFromS0, la fonction définit le membre DxState sur PowerDeviceD3.
Exemples
Pour obtenir un exemple de code qui utilise WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT, consultez WdfDeviceAssignS0IdleSettings.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| Version KMDF minimale | 1.0 |
| Version UMDF minimale | 2.0 |
| En-tête | wdfdevice.h (include Wdf.h) |