Compartir a través de

estructura de BATTERY_SET_INFORMATION

  • Artículo

Contiene información de batería que se va a establecer. Esta estructura se usa con el código de control IOCTL_BATTERY_SET_INFORMATION .

Sintaxis

typedef struct _BATTERY_SET_INFORMATION {
  ULONG                         BatteryTag;
  BATTERY_SET_INFORMATION_LEVEL InformationLevel;
  UCHAR                         Buffer[1];
} BATTERY_SET_INFORMATION, *PBATTERY_SET_INFORMATION;

Miembros

BatteryTag

La etiqueta de batería actual para la batería. La información de una batería que coincida con la etiqueta solo se puede devolver. Siempre que este valor no coincida con la etiqueta actual de la batería, la solicitud IOCTL se completará con ERROR_FILE_NOT_FOUND, lo que indica al autor de la llamada que la batería para la que tiene una etiqueta ya no existe. El autor de la llamada puede optar por usar la operación de IOCTL_BATTERY_QUERY_TAG para determinar la etiqueta de la batería recién instalada, si existe. (Consulte Etiquetas de batería para obtener más información).

Cuando se realiza una solicitud de información de consulta, se comprueba este valor. Además, si la solicitud está en curso mientras cambia este valor, la solicitud se anula con el estado de ERROR_FILE_NOT_FOUND.

InformationLevel

La información de la batería que se va a establecer. El tipo de datos del miembro Buffer depende del valor de este miembro. Este miembro puede ser uno de los valores siguientes.

Valor Significado
BatteryCharge
1
 Informa al dispositivo de batería que el usuario ha solicitado que la batería se cargue en este momento. Por ejemplo, con un cargador o selector de batería inteligente, la aplicación podría cargar una batería a la vez. Se omite el miembro buffer de esta estructura.
BatteryCriticalBias
0
 Establece el ajuste de sesgo crítico de la batería. Tenga en cuenta que no está previsto que el software cambie normalmente este valor y que solo esté presente en las interfaces como una característica de mantenimiento. No todas las baterías pueden mantener este ajuste, y la información de la batería debe leerse para confirmar que la batería aceptó la configuración.
BatteryDischarge
2
 Informa al dispositivo de batería que el usuario ha solicitado que la batería se descargó en este momento. Por ejemplo, esto podría usarse para indicar la batería que el usuario quiere actualmente encender el sistema. Se omite el miembro buffer de esta estructura.

Buffer

La información de la batería que se va a establecer. Los datos dependen del valor de InformationLevel.

Comentarios

La estructura BATTERY_SET_INFORMATION es una estructura de longitud variable y debe asignar un búfer de tamaño adecuado para que la información se incluya en la estructura.

Requisitos

Requisito Value
Cliente mínimo compatible
 Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible
 Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado
Poclass.h;
Batclass.h en Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP

Consulte también

IOCTL_BATTERY_SET_INFORMATION