BATTERY_SET_INFORMATION structure

Contient des informations sur la batterie à définir. Cette structure est utilisée avec le code de contrôle IOCTL_BATTERY_SET_INFORMATION .

Syntaxe

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

Membres

BatteryTag

Étiquette de batterie actuelle pour la batterie. Les informations relatives à une batterie correspondant à l’étiquette ne peuvent être retournées que. Chaque fois que cette valeur ne correspond pas à la balise actuelle de la batterie, la requête IOCTL est effectuée avec ERROR_FILE_NOT_FOUND, ce qui indique à l’appelant que la batterie pour laquelle il a une balise n’existe plus. L’appelant peut choisir d’utiliser l’opération IOCTL_BATTERY_QUERY_TAG pour déterminer la balise de la batterie nouvellement installée, le cas échéant. (Pour plus d’informations, consultez Étiquettes de batterie .)

Lorsqu’une demande d’informations de requête est effectuée, cette valeur est vérifiée. En outre, si la requête est en cours pendant que cette valeur change, la requête est abandonnée avec la status de ERROR_FILE_NOT_FOUND.

InformationLevel

Informations sur la batterie à définir. Le type de données dans le membre Buffer dépend de la valeur de ce membre. Ce membre peut être l’une des valeurs suivantes.

Valeur	Signification
BatteryCharge 1	Informe l’appareil à batterie que l’utilisateur a demandé que la batterie soit en cours de chargement. Par exemple, avec une batterie/chargeur/sélecteur intelligent, l’application peut charger une batterie à la fois. Le membre Buffer de cette structure est ignoré.
BatteryCriticalBias 0	Définit le réglage du biais critique de la batterie. Notez qu’il n’est pas prévu que cette valeur soit normalement modifiée par le logiciel et qu’elle est présente dans les interfaces uniquement en tant que fonctionnalité de maintenance. Toutes les batteries ne peuvent pas conserver un tel paramètre, et les informations sur la batterie doivent être lues pour confirmer que la batterie a accepté le paramètre.
BatteryDischargement 2	Informe l’appareil à batterie que l’utilisateur a demandé que la batterie soit décharge à ce stade. Par exemple, cela peut être utilisé pour indiquer la batterie que l’utilisateur souhaite actuellement alimenter le système. Le membre Buffer de cette structure est ignoré.

Buffer

Informations sur la batterie à définir. Les données dépendent de la valeur de InformationLevel.

Notes

La structure BATTERY_SET_INFORMATION est une structure de longueur variable, et vous devez allouer une mémoire tampon de taille appropriée pour les informations à inclure dans la structure.

Spécifications

Voir aussi

IOCTL_BATTERY_SET_INFORMATION