Share via

fonction WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT (wudfdevice.h)

  • Article

[Avertissement : UMDF 2 est la dernière version d’UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide d’UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et la prise en charge d’UMDF 1 est limitée sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Prise en main avec UMDF.]

La fonction WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT initialise la structure WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS d’un pilote.

Syntaxe

void WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT(
  [out] PWUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS Settings,
  [in]  WDF_POWER_POLICY_S0_IDLE_CAPABILITIES   IdleCaps
);

Paramètres

[out] Settings

Pointeur vers une structure de WUDF_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 WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT zéro la structure WUDF_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.

La fonction définit ensuite 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.

Pour obtenir un exemple de code qui utilise WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT, consultez IWDFDevice3 ::AssignS0IdleSettingsEx.

Configuration requise

Condition requise Valeur
Fin de la prise en charge Non disponible dans UMDF 2.0 et versions ultérieures.
Plateforme cible Desktop (Expérience utilisateur)
Version UMDF minimale 1.11
En-tête wudfdevice.h

Voir aussi

IWDFDevice3 ::AssignS0IdleSettingsEx

WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS