Share via

struttura EXT_SET_PARAMETERS (wdm.h)

  • Articolo

La struttura EXT_SET_PARAMETERS contiene un set esteso di parametri per la routine ExSetTimer .

Sintassi

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

Members

Version

Numero di versione della struttura EXT_SET_PARAMETERS . La routine ExInitializeSetTimerParameters imposta questo membro sul numero di versione corretto.

Reserved

Imposta su zero. La routine ExInitializeSetTimerParameters imposta questo membro su zero.

NoWakeTolerance

Tempo massimo, in unità di tempo di sistema (intervalli di 100 nanosecondi), che il timer può attendere la riattivazione del processore dopo che il timer raggiunge la scadenza. Solo dopo la riattivazione del processore può scadere il timer. Se un timer è impostato per scadere quando il processore è in uno stato a basso consumo, il timer non attiverà il processore per scadere fino all'ora di scadenza più il ritardo NoWakeTolerance viene superato. Come opzione, un driver può impostare questo membro su EX_TIMER_UNLIMITED_TOLERANCE, che indica che il timer non riattiva mai il processore e, pertanto, non può scadere fino alla riattivazione del processore per qualche altro motivo.

Non impostare questo membro su un valore negativo (diverso da EX_TIMER_UNLIMITED_TOLERANCE). In caso contrario, il controllo dei bug di routine.

Commenti

Il parametro Parameters della routine ExSetTimer è un puntatore a una struttura EXT_SET_PARAMETERS . Prima di passare una struttura EXT_SET_PARAMETERS a questa routine, chiamare la routine ExInitializeSetTimerParameters per inizializzare la struttura.

La routine ExInitializeSetTimerParameters imposta il membro NoWakeTolerance su zero, il che significa che il timer riattiva immediatamente il processore se il timer raggiunge la scadenza quando il processore è in uno stato a basso consumo. Per ridurre il consumo di energia, un driver può impostare questo membro su un valore diverso da zero per estendere il tempo trascorso dal processore in uno stato a basso consumo.

Requisiti

Requisito Valore
Client minimo supportato Supportato a partire da Windows 8.1.
Intestazione wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)

Vedi anche

ExInitializeSetTimerParameters

ExSetTimer