structure EXT_SET_PARAMETERS (wdm.h)

  • Article

La structure EXT_SET_PARAMETERS contient un ensemble étendu de paramètres pour la routine ExSetTimer .

Syntaxe

typedef struct _EXT_SET_PARAMETERS_V0 {
  ULONG    Version;
  ULONG    Reserved;
  LONGLONG NoWakeTolerance;
} EXT_SET_PARAMETERS, *PEXT_SET_PARAMETERS;

Membres

Version

Numéro de version de cette structure EXT_SET_PARAMETERS . La routine ExInitializeSetTimerParameters définit ce membre sur le numéro de version correct.

Reserved

Définit la valeur zéro. La routine ExInitializeSetTimerParameters définit ce membre sur zéro.

NoWakeTolerance

Durée maximale, en unités de temps système (intervalles de 100 nanosecondes), pendant laquelle le minuteur peut attendre le réveil du processeur une fois que le minuteur a atteint son heure d’expiration. Ce n’est qu’après le réveil du processeur que le minuteur peut expirer. Si un minuteur est configuré pour expirer lorsque le processeur est dans un état de faible consommation, le minuteur ne réveille pas le processeur pour expirer tant que le délai d’expiration plus le délai NoWakeTolerance n’est pas dépassé. En option, un pilote peut définir ce membre sur EX_TIMER_UNLIMITED_TOLERANCE, ce qui indique que le minuteur ne réveille jamais le processeur et, par conséquent, ne peut pas expirer tant que le processeur n’est pas mis en éveil pour une autre raison.

Ne définissez pas ce membre sur une valeur négative (autre que EX_TIMER_UNLIMITED_TOLERANCE). Sinon, les vérifications de bogues de routine.

Remarques

Le paramètre Parameters de la routine ExSetTimer est un pointeur vers une structure EXT_SET_PARAMETERS . Avant de passer une structure EXT_SET_PARAMETERS à cette routine, appelez la routine ExInitializeSetTimerParameters pour initialiser la structure.

La routine ExInitializeSetTimerParameters définit le membre NoWakeTolerance sur zéro, ce qui signifie que le minuteur réveille immédiatement le processeur si le minuteur atteint son heure d’expiration lorsque le processeur est dans un état de faible consommation. Pour réduire la consommation d’énergie, un pilote peut définir ce membre sur une valeur différente de zéro afin d’étendre le temps que le processeur passe dans un état de faible consommation.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Pris en charge à partir de Windows 8.1.
En-tête wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)

Voir aussi

ExInitializeSetTimerParameters

ExSetTimer