BatteryPDDGetStatus
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa função obtém the most atual bateria e status de energia disponível sobre a plataforma. Ele preenche as estruturas apontadas por seus parâmetros.
Syntax
BOOL WINAPI BatteryPDDGetStatus(
PSYSTEM_POWER_STATUS_EX2 pstatus,
PBOOL pfBatteriesChangedSinceLastCall
);
Parameters
- pstatus
[out] Ponteiro para um SYSTEM_POWER_STATUS_EX2 estrutura.
- pfBatteriesChangedSinceLastCall
[out] Ponteiro para um sinalizador que a função define como TRUE se o usuário substituído ou alterados baterias do sistema desde a última chamar para essa função. Os drivers bateria somente defina este valor como TRUE se do o driver BatteryDrvrSupportsChangeNotification implementação retorna TRUE.
Return Value
Retorna TRUE se bem-sucedido. Retorna FALSE se há um erro. Na falha, essa rotina deve registro seu uso razão falha SetLastError.
Remarks
Ao implementar BatteryPDDGetStatus, o apropriado informações bateria preenche a SYSTEM_POWER_STATUS_EX2 estrutura. Declare uma variável do tipo SYSTEM_POWER_STATUS_EX2 Como um ponteiro para a reserva de retorno que contém informações de status bateria. O pfBatteriesChangedSinceLastCall parâmetro é um ponteiro para o sinalizador e é definido como TRUE se o usuário substituído ou alterados baterias do sistema desde a última chamar para essa função.
Para retornar informações adicionais bateria, such as informações sobre um adicional bateria, fornecer uma reserva dados maior que SYSTEM_POWER_STATUS_EX2 in a GetSystemPowerStatusEx2 função. Qualquer adicional informações devem ser adicionadas após o BatteryChemistry membro da estrutura de SYSTEM_POWER_STATUS_EX2. Deve haver suporte para este implementado no driver de bateria, e a implementação desse suporte varia depending on plataforma de hardware.
Observação
Essa função estaticamente está vinculada ao driver de bateria MDD.
Requirements
| Header | battimpl.h |
| Windows Embedded CE | Windows CE .NET 4.2 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |
| Note | Statically linked to the battery driver MDD |
See Also
Reference
BatteryDrvrSupportsChangeNotification