Compartilhar via


estrutura SYSTEM_POWER_CAPABILITIES (winnt.h)

Contém informações sobre os recursos de energia do sistema.

Sintaxe

typedef struct {
  BOOLEAN                 PowerButtonPresent;
  BOOLEAN                 SleepButtonPresent;
  BOOLEAN                 LidPresent;
  BOOLEAN                 SystemS1;
  BOOLEAN                 SystemS2;
  BOOLEAN                 SystemS3;
  BOOLEAN                 SystemS4;
  BOOLEAN                 SystemS5;
  BOOLEAN                 HiberFilePresent;
  BOOLEAN                 FullWake;
  BOOLEAN                 VideoDimPresent;
  BOOLEAN                 ApmPresent;
  BOOLEAN                 UpsPresent;
  BOOLEAN                 ThermalControl;
  BOOLEAN                 ProcessorThrottle;
  BYTE                    ProcessorMinThrottle;
  BYTE                    ProcessorThrottleScale;
  BYTE                    spare2[4];
  BYTE                    ProcessorMaxThrottle;
  BOOLEAN                 FastSystemS4;
  BOOLEAN                 Hiberboot;
  BOOLEAN                 WakeAlarmPresent;
  BOOLEAN                 AoAc;
  BOOLEAN                 DiskSpinDown;
#if ...
  BYTE                    spare3[8];
  BYTE                    HiberFileType;
  BOOLEAN                 AoAcConnectivitySupported;
#else
  BYTE                    spare3[6];
#endif
  BOOLEAN                 SystemBatteriesPresent;
  BOOLEAN                 BatteriesAreShortTerm;
  BATTERY_REPORTING_SCALE BatteryScale[3];
  SYSTEM_POWER_STATE      AcOnLineWake;
  SYSTEM_POWER_STATE      SoftLidWake;
  SYSTEM_POWER_STATE      RtcWake;
  SYSTEM_POWER_STATE      MinDeviceWakeState;
  SYSTEM_POWER_STATE      DefaultLowLatencyWake;
} SYSTEM_POWER_CAPABILITIES, *PSYSTEM_POWER_CAPABILITIES;

Membros

PowerButtonPresent

Se esse membro for TRUE, haverá um botão de energia do sistema.

SleepButtonPresent

Se esse membro for TRUE, haverá um botão de suspensão do sistema.

LidPresent

Se esse membro for TRUE, haverá uma opção de tampa.

SystemS1

Se esse membro for TRUE, o sistema operacional oferecerá suporte ao estado de suspensão S1.

SystemS2

Se esse membro for TRUE, o sistema operacional oferecerá suporte ao estado de suspensão S2.

SystemS3

Se esse membro for TRUE, o sistema operacional oferecerá suporte ao estado de suspensão S3.

SystemS4

Se esse membro for TRUE, o sistema operacional oferecerá suporte ao estado de suspensão S4 (hibernação).

SystemS5

Se esse membro for TRUE, o sistema operacional oferecerá suporte à desligar o estado S5 (desativação temporária).

HiberFilePresent

Se esse membro for TRUE, o arquivo de hibernação do sistema estará presente.

FullWake

Se esse membro for TRUE, o sistema oferecerá suporte a recursos de ativação.

VideoDimPresent

Se esse membro for TRUE, o sistema oferecerá suporte a recursos de esmaecimento de vídeo.

ApmPresent

Se esse membro for TRUE, o sistema oferecerá suporte aos recursos de gerenciamento de energia do BIOS do APM.

UpsPresent

Se esse membro for TRUE, haverá um UPS (fonte de alimentação ininterrupta).

ThermalControl

Se esse membro for TRUE, o sistema oferecerá suporte a zonas térmicas.

ProcessorThrottle

Se esse membro for TRUE, o sistema oferecerá suporte à limitação do processador.

ProcessorMinThrottle

O nível mínimo de limitação do processador do sistema com suporte, expresso como uma porcentagem.

ProcessorThrottleScale

spare2[4]

ProcessorMaxThrottle

O nível máximo de limitação do processador do sistema com suporte, expresso como uma porcentagem.

FastSystemS4

Se esse membro for TRUE, o sistema oferecerá suporte ao estado de suspensão híbrida.

Hiberboot

WakeAlarmPresent

Se esse membro for TRUE, a plataforma terá suporte para dispositivos de alarme de ativação ACPI. Para obter mais detalhes sobre dispositivos de alarme de ativação, consulte a seção especificação de ACPI 9.18.

AoAc

Se esse membro for TRUE, o sistema oferecerá suporte ao modelo ocioso de baixa energia S0.

DiskSpinDown

Se esse membro for TRUE, o sistema permitirá a remoção de energia para dispositivos de disco fixos.

spare3[8]

Reservado.

HiberFileType

AoAcConnectivitySupported

spare3[6]

Reservado.

SystemBatteriesPresent

Se esse membro for TRUE, há uma ou mais baterias no sistema.

BatteriesAreShortTerm

Se esse membro for TRUE, as baterias do sistema serão de curto prazo. As baterias de curto prazo são usadas em fontes de alimentação ininterruptas (UPS).

BatteryScale[3]

Uma estrutura BATTERY_REPORTING_SCALE que contém informações sobre como as métricas de bateria do sistema são relatadas.

AcOnLineWake

O estado de suspensão do sistema (Sx) mais baixo que gerará um evento de ativação quando o sistema estiver na energia AC. Esse membro deve ser um dos valores de tipo de enumeração SYSTEM_POWER_STATE .

SoftLidWake

O estado de suspensão do sistema (Sx) mais baixo que gerará um evento de ativação por meio do comutador de tampa. Esse membro deve ser um dos valores de tipo de enumeração SYSTEM_POWER_STATE .

RtcWake

O estado de suspensão do sistema (Sx) mais baixo com suporte pelo hardware que gerará um evento de ativação por meio do RTC (Relógio em Tempo Real). Esse membro deve ser um dos valores de tipo de enumeração SYSTEM_POWER_STATE .

Para ativar o computador usando o RTC, o sistema operacional também deve dar suporte à ativação do estado de suspensão em que o computador está quando o RTC gera o evento de ativação. Portanto, o estado de suspensão mais baixo efetivo do qual um evento de ativação RTC pode ativar o computador é o estado de suspensão mais baixo suportado pelo sistema operacional que é igual ou maior que o valor de RtcWake. Para determinar os estados de suspensão aos quais o sistema operacional dá suporte, marcar os membros SystemS1, SystemS2, SystemS3 e SystemS4.

MinDeviceWakeState

O estado mínimo permitido de energia do sistema que dá suporte a eventos de ativação. Esse membro deve ser um dos valores de tipo de enumeração SYSTEM_POWER_STATE . Observe que esse estado pode mudar conforme drivers de dispositivo diferentes são instalados no sistema.

DefaultLowLatencyWake

O estado de energia do sistema padrão usado se um aplicativo chamar RequestWakeupLatency com LT_LOWEST_LATENCY. Esse membro deve ser um dos valores de tipo de enumeração SYSTEM_POWER_STATE .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho winnt.h (inclua Windows.h)

Confira também

CallNtPowerInformation

Estados de energia do sistema