estrutura EXT_SET_PARAMETERS (wdm.h)

  • Artigo

A estrutura EXT_SET_PARAMETERS contém um conjunto estendido de parâmetros para a rotina ExSetTimer .

Sintaxe

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

Membros

Version

O número de versão dessa estrutura EXT_SET_PARAMETERS . A rotina ExInitializeSetTimerParameters define esse membro como o número de versão correto.

Reserved

Defina como zero. A rotina ExInitializeSetTimerParameters define esse membro como zero.

NoWakeTolerance

O tempo máximo, em unidades de tempo do sistema (intervalos de 100 nanossegundos), que o temporizador pode esperar para ativar o processador depois que o temporizador atingir seu tempo de expiração. Somente após a ativação do processador o temporizador poderá expirar. Se um temporizador estiver definido para expirar quando o processador estiver em um estado de baixa potência, o temporizador não ativará o processador para expirar até que o tempo de expiração mais o atraso no NoWakeTolerance seja excedido. Como opção, um driver pode definir esse membro como EX_TIMER_UNLIMITED_TOLERANCE, o que indica que o temporizador nunca ativa o processador e, portanto, não pode expirar até que o processador seja ativado por algum outro motivo.

Não defina esse membro como um valor negativo (diferente de EX_TIMER_UNLIMITED_TOLERANCE). Caso contrário, o bug de rotina verifica.

Comentários

O parâmetro Parameters da rotina ExSetTimer é um ponteiro para uma estrutura EXT_SET_PARAMETERS . Antes de passar uma estrutura EXT_SET_PARAMETERS para essa rotina, chame a rotina ExInitializeSetTimerParameters para inicializar a estrutura.

A rotina ExInitializeSetTimerParameters define o membro NoWakeTolerance como zero, o que significa que o temporizador ativa imediatamente o processador se o temporizador atingir seu tempo de expiração quando o processador estiver em um estado de baixa potência. Para reduzir o consumo de energia, um driver pode definir esse membro como um valor diferente de zero para estender o tempo gasto pelo processador em um estado de baixa potência.

Requisitos

Requisito Valor
Cliente mínimo com suporte Com suporte a partir de Windows 8.1.
Cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)

Confira também

ExInitializeSetTimerParameters

ExSetTimer