estructura de EXT_SET_PARAMETERS (wdm.h)

  • Artículo

La estructura EXT_SET_PARAMETERS contiene un conjunto extendido de parámetros para la rutina ExSetTimer .

Sintaxis

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

Miembros

Version

Número de versión de esta estructura de EXT_SET_PARAMETERS . La rutina ExInitializeSetTimerParameters establece este miembro en el número de versión correcto.

Reserved

Establecer en cero. La rutina ExInitializeSetTimerParameters establece este miembro en cero.

NoWakeTolerance

El tiempo máximo, en unidades de tiempo del sistema (intervalos de 100 nanosegundos), que el temporizador puede esperar para reactivar el procesador después de que el temporizador alcance su tiempo de expiración. Solo después de que el procesador se despierte puede expirar el temporizador. Si se establece un temporizador para que expire cuando el procesador está en estado de baja potencia, el temporizador no reactivará el procesador para que expire hasta que expire la hora de expiración más el retraso de NoWakeTolerance . Como opción, un controlador puede establecer este miembro en EX_TIMER_UNLIMITED_TOLERANCE, lo que indica que el temporizador nunca reactiva el procesador y, por lo tanto, no puede expirar hasta que el procesador se reactiva por algún otro motivo.

No establezca este miembro en un valor negativo (distinto de EX_TIMER_UNLIMITED_TOLERANCE). De lo contrario, se comprueban los errores rutinarios.

Comentarios

El parámetro Parameters de la rutina ExSetTimer es un puntero a una estructura EXT_SET_PARAMETERS . Antes de pasar una estructura de EXT_SET_PARAMETERS a esta rutina, llame a la rutina ExInitializeSetTimerParameters para inicializar la estructura.

La rutina ExInitializeSetTimerParameters establece el miembro NoWakeTolerance en cero, lo que significa que el temporizador reactiva inmediatamente el procesador si el temporizador alcanza su hora de expiración cuando el procesador está en un estado de baja potencia. Para reducir el consumo de energía, un controlador puede establecer este miembro en un valor distinto de cero para ampliar el tiempo que el procesador invierte en un estado de bajo consumo.

Requisitos

Requisito Value
Cliente mínimo compatible Se admite a partir de Windows 8.1.
Encabezado wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)

Consulte también

ExInitializeSetTimerParameters

ExSetTimer