estrutura BATTERY_SET_INFORMATION
Contém informações de bateria a serem definidas. Essa estrutura é usada com o código de controle IOCTL_BATTERY_SET_INFORMATION .
Sintaxe
typedef struct _BATTERY_SET_INFORMATION {
ULONG BatteryTag;
BATTERY_SET_INFORMATION_LEVEL InformationLevel;
UCHAR Buffer[1];
} BATTERY_SET_INFORMATION, *PBATTERY_SET_INFORMATION;
Membros
-
BatteryTag
-
A marca da bateria atual para a bateria. As informações de uma bateria correspondente à marca só podem ser retornadas. Sempre que esse valor não corresponder à marca atual da bateria, a solicitação IOCTL será concluída com ERROR_FILE_NOT_FOUND, o que indica ao chamador que a bateria para a qual ela tem uma marca não existe mais. O chamador pode optar por usar a operação IOCTL_BATTERY_QUERY_TAG para determinar a marca da bateria recém-instalada, se houver uma. (Consulte Marcas de bateria para obter mais informações.)
Quando uma solicitação de informações de consulta é feita, esse valor é verificado. Além disso, se a solicitação estiver em andamento enquanto esse valor for alterado, a solicitação será anulada com o status de ERROR_FILE_NOT_FOUND.
-
InformationLevel
-
As informações da bateria a serem definidas. O tipo de dados no membro Buffer depende do valor desse membro. Esse membro pode ser um dos valores a seguir.
Valor Significado - BatteryCharge
- 1
Informa ao dispositivo de bateria que o usuário solicitou que a bateria fosse carregada no momento. Por exemplo, com uma bateria inteligente/carregador/seletor, o aplicativo poderia carregar uma bateria por vez. O membro buffer dessa estrutura é ignorado. - BatteryCriticalBias
- 0
Define o ajuste de viés crítico da bateria. Observe que não é previsto que esse valor normalmente seria alterado por software e está presente nas interfaces apenas como um recurso de manutenção. Nem todas as baterias podem manter essa configuração, e as informações da bateria devem ser lidas para confirmar que a bateria aceitou a configuração. - BatteryDischarge
- 2
Informa ao dispositivo de bateria que o usuário solicitou que a bateria fosse descarregada no momento. Por exemplo, isso pode ser usado para indicar qual bateria o usuário deseja ligar o sistema no momento. O membro buffer dessa estrutura é ignorado. -
Buffer
-
As informações da bateria a serem definidas. Os dados dependem do valor de InformationLevel.
Comentários
A estrutura BATTERY_SET_INFORMATION é uma estrutura de comprimento variável e você deve alocar um buffer de tamanho adequado para que as informações sejam incluídas na estrutura.
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 |
|