Freigeben über


EXT_SET_PARAMETERS Struktur (wdm.h)

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;

Angehörige

Version

Die Versionsnummer dieser EXT_SET_PARAMETERS Struktur. Die ExInitializeSetTimerParameters Routine legt dieses Element auf die richtige Versionsnummer fest.

Reserved

Auf Null festgelegt. Die ExInitializeSetTimerParameters Routine legt dieses Element auf 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 dem Aufwachen des Prozessors kann der Zeitgeber ablaufen. Wenn ein Timer so eingestellt ist, dass er abläuft, wenn sich der Prozessor in einem Energiesparzustand befindet, wird der Zeitgeber erst nach ablaufen, wenn der Prozessor abläuft, bis die Ablaufzeit plus die NoWakeTolerance Verzögerung überschritten wird. Als Option kann ein Treiber dieses Element auf EX_TIMER_UNLIMITED_TOLERANCE festlegen, was angibt, dass der Timer den Prozessor nie reaktiviert und daher erst abläuft, wenn der Prozessor aus einem anderen Grund reaktiviert wird.

Legen Sie dieses Element nicht auf einen negativen Wert (außer EX_TIMER_UNLIMITED_TOLERANCE) fest. Andernfalls werden die Routinefehlerüberprüfungen durchgeführt.

Bemerkungen

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 die NoWakeTolerance Element auf Null fest, was bedeutet, dass der Timer den Prozessor sofort reaktiviert, wenn der Timer seine Ablaufzeit erreicht, wenn der Prozessor in einem Zustand mit niedriger Leistung ist. Um den Stromverbrauch zu reduzieren, kann ein Treiber dieses Element auf einen Wert ungleich Null festlegen, um die Zeit zu verlängern, die der Prozessor in einem Energiesparzustand verbringt.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Wird ab Windows 8.1 unterstützt.
Header- wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)

Siehe auch

ExInitializeSetTimerParameters

ExSetTimer-