estructura de BATTERY_SET_INFORMATION
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 |
|