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) |