SYSTEM_BATTERY_STATE 構造体 (winnt.h)

システム バッテリの現在の状態に関する情報が含まれます。

構文

typedef struct {
  BOOLEAN AcOnLine;
  BOOLEAN BatteryPresent;
  BOOLEAN Charging;
  BOOLEAN Discharging;
  BOOLEAN Spare1[3];
  BYTE    Tag;
  DWORD   MaxCapacity;
  DWORD   RemainingCapacity;
  DWORD   Rate;
  DWORD   EstimatedTime;
  DWORD   DefaultAlert1;
  DWORD   DefaultAlert2;
} SYSTEM_BATTERY_STATE, *PSYSTEM_BATTERY_STATE;

メンバー

AcOnLine

このメンバーが TRUE の場合、システム・バッテリー・チャージャは現在外部電源で動作しています。

BatteryPresent

このメンバーが TRUE の場合、システムには少なくとも 1 つのバッテリーが存在します。

Charging

このメンバーが TRUE の場合、バッテリーは現在充電中です。

Discharging

このメンバーが TRUE の場合、バッテリは現在放電中です。

Spare1[3]

予約済み。

Tag

MaxCapacity

新しい場合のバッテリの理論上の容量。

RemainingCapacity

バッテリーの推定残存容量。

Rate

バッテリの放電の現在の速度 (mW 単位)。 0 以外の正のレートは充電を示します。負のレートは放電を示します。 一部のバッテリでは、放電率のみが報告されます。 この値は、負の値 (上位ビットが設定されている) を含むことができるため 、LONG として扱う必要があります。

EstimatedTime

バッテリーの残りの推定時間 (秒単位)。

DefaultAlert1

バッテリ不足のアラートが発生する必要がある容量 (mWh) の製造元の提案。 低の定義は、製造元によって異なります。 一般に、警告状態は低い状態の前に発生しますが、常に警告状態になるとは限りません。 データ損失のリスクを軽減するために、この値は通常、重要なバッテリ アラームの既定の設定として使用されます。

DefaultAlert2

製造元が提案した容量 (mWh) で、バッテリー警告が発生する必要があります。 警告の定義は製造元によって異なります。 一般に、警告状態は低い状態の前に発生しますが、常に警告状態になるとは限りません。 データ損失のリスクを軽減するために、この値は通常、バッテリ残量の少ないアラームの既定の設定として使用されます。

要件

サポートされている最小のクライアント	Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 [デスクトップ アプリのみ]
ヘッダー	winnt.h (Windows.h を含む)

こちらもご覧ください

CallNtPowerInformation