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

Voir aussi

WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS