EXT_SET_PARAMETERS-Struktur (wdm.h)

  • Artikel

Die EXT_SET_PARAMETERS-Struktur enthält einen erweiterten Satz von Parametern für die ExSetTimer-Routine .

Syntax

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

Member

Version

Die Versionsnummer dieser EXT_SET_PARAMETERS-Struktur . Die ExInitializeSetTimerParameters-Routine legt diesen Member auf die richtige Versionsnummer fest.

Reserved

Auf NULL festlegen. Die ExInitializeSetTimerParameters-Routine legt diesen Member auf 0 (null) fest.

NoWakeTolerance

Die maximale Zeit in Systemzeiteinheiten (100-Nanosekunden-Intervalle), die der Timer warten kann, um den Prozessor zu reaktivieren, nachdem der Timer seine Ablaufzeit erreicht hat. Erst nach der Aktivierung des Prozessors kann der Timer ablaufen. Wenn festgelegt ist, dass ein Timer abläuft, wenn sich der Prozessor in einem Energiesparzustand befindet, aktiviert der Timer den Prozessor erst, wenn die Ablaufzeit plus die NoWakeTolerance-Verzögerung überschritten wird. Optional kann ein Treiber diesen Member auf EX_TIMER_UNLIMITED_TOLERANCE festlegen, was angibt, dass der Timer den Prozessor nie reaktiviert und daher nicht ablaufen kann, bis der Prozessor aus einem anderen Grund reaktiviert wird.

Legen Sie diesen Member nicht auf einen negativen Wert fest (außer EX_TIMER_UNLIMITED_TOLERANCE). Andernfalls werden routinemäßige Fehlerüberprüfungen durchgeführt.

Hinweise

Der Parameters-Parameter der ExSetTimer-Routine ist ein Zeiger auf eine EXT_SET_PARAMETERS-Struktur . Rufen Sie vor dem Übergeben einer EXT_SET_PARAMETERS-Struktur an diese Routine die ExInitializeSetTimerParameters-Routine auf, um die Struktur zu initialisieren.

Die ExInitializeSetTimerParameters-Routine legt den NoWakeTolerance-Member auf 0 (null) fest. Dies bedeutet, dass der Timer den Prozessor sofort reaktiviert, wenn der Timer seine Ablaufzeit erreicht, wenn sich der Prozessor in einem Energiesparzustand befindet. Um den Stromverbrauch zu reduzieren, kann ein Treiber diesen Member auf einen Wert ungleich Null festlegen, um die Zeit zu verlängern, die der Prozessor in einem Energiesparzustand verbringt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Unterstützt ab Windows 8.1.
Header wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)

Weitere Informationen

ExInitializeSetTimerParameters

ExSetTimer