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éfini sur zéro. La routine ExInitializeSetTimerParameters définit ce membre sur zéro.
NoWakeTolerance
Durée maximale, dans les unités de temps système (intervalles de 100 nanosecondes), que le minuteur peut attendre pour réveiller le processeur une fois que le minuteur atteint son heure d’expiration. Une fois les sorties de veille du processeur terminées, le minuteur expire. Si un minuteur est défini pour expirer lorsque le processeur est dans un état à faible alimentation, le minuteur ne réveille pas le processeur jusqu’à ce que l’heure d’expiration plus le délai d’expiration NoWakeTolerance est dépassé. En guise d’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 ne se réveille pas 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 routine pour initialiser la structure.
La routine ExInitializeSetTimerParameters définit la NoWakeTolerance membre sur zéro, ce qui signifie que le minuteur se réveille immédiatement le processeur si le minuteur atteint son délai d’expiration lorsque le processeur est dans un état de faible puissance. Pour réduire la consommation d’énergie, un pilote peut définir ce membre sur une valeur différente de zéro pour prolonger le temps passé par le processeur dans un état de faible puissance.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Prise en charge à partir de Windows 8.1. |
| d’en-tête | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |