Compartir a través de


estructura EXT_SET_PARAMETERS (wdm.h)

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

Establézcalo 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 un temporizador está establecido para expirar 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 noWakeTolerance retraso se supera. 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 errores rutinarios.

Observaciones

El parámetro Parameters de la rutina ExSetTimer es un puntero a una estructura de 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 noWakeTolerance miembro a cero, lo que significa que el temporizador activa 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 pasa en un estado de baja potencia.

Requisitos

Requisito Valor
cliente mínimo admitido Se admite a partir de Windows 8.1.
encabezado de wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)

Consulte también

ExInitializeSetTimerParameters

ExSetTimer