structure EXT_SET_PARAMETERS (wdm.h)
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) |