Função PoSetSystemState (wdm.h)

  • Artigo

Os drivers chamam a rotina PoSetSystemState para indicar que o sistema está ativo.

Sintaxe

void PoSetSystemState(
  [in] EXECUTION_STATE Flags
);

Parâmetros

[in] Flags

Indica a atividade do sistema, conforme especificado por um OR bit a bit de um ou mais dos seguintes valores:

ES_SYSTEM_REQUIRED

O sistema não está ocioso, independentemente da carga aparente.

ES_DISPLAY_REQUIRED

O uso da exibição é necessário.

ES_USER_PRESENT

Um usuário está presente.

Retornar valor

Nenhum

Comentários

Um driver chama PoSetSystemState para definir sinalizadores que indicam que a atividade do sistema está ocorrendo. Ao contrário de PoRegisterSystemState, essa rotina não permite que o driver defina um estado ocupado persistente.

O parâmetro Flags especifica o tipo de atividade que ocorre. Os drivers podem especificar qualquer combinação dos sinalizadores.

Os drivers podem definir o estado ocupado do sistema para solicitar que o sistema evite sair do estado de trabalho enquanto a atividade do driver está ocorrendo. Observe, no entanto, que em algumas circunstâncias (como uma bateria criticamente baixa), o gerenciador de energia pode substituir essa solicitação e colocar o sistema em suspensão de qualquer maneira.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível a partir do Windows 2000.
Plataforma de Destino Universal
Cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <=DISPATCH_LEVEL

Confira também

PoRegisterSystemState

PoUnregisterSystemState