BATTERY_STATUS構造体

バッテリーの現在の状態を格納します。 この構造体は、 IOCTL_BATTERY_QUERY_STATUS コントロール コードによって使用されます。

構文

typedef struct _BATTERY_STATUS {
  ULONG PowerState;
  ULONG Capacity;
  ULONG Voltage;
  LONG  Rate;
} BATTERY_STATUS, *PBATTERY_STATUS;

メンバー

PowerState

バッテリーの状態。 このメンバーには、次の値の 0、1、または複数を指定できます。

値	説明
BATTERY_CHARGING 0x00000004	バッテリーが現在充電中であることを示します。
BATTERY_CRITICAL 0x00000008	バッテリーの故障が差し迫っていることを示します。 詳細については、次の「解説」を参照してください。
BATTERY_DISCHARGING 0x00000002	バッテリが現在放電中であることを示します。
BATTERY_POWER_ON_LINE 0x00000001	システムが AC 電源にアクセスできるため、バッテリが放電されていないことを示します。

[容量]

現在のバッテリ容量 (mWh (または相対単位)。 この値を使用すると、BATTERY_INFORMATION構造体の FullChargedCapacity メンバーで除算することで、"ガス ゲージ" 表示を生成できます。 容量が使用できない場合、このメンバーはBATTERY_UNKNOWN_CAPACITY。

電圧

バッテリ端子全体の現在のバッテリ電圧 (ミリボルト (mv) 単位)。 電圧が使用できない場合、このメンバーはBATTERY_UNKNOWN_VOLTAGE。

料金

バッテリの充電または放電の現在のレート。 この値は、バッテリ レート情報が相対的でない限りミリワット単位になります。その場合は、1 時間あたりに任意の単位になります。 バッテリ情報が相対的であるかどうかを判断するには、BATTERY_INFORMATION構造体の Capabilities メンバーの BATTERY_CAPACITY_RELATIVE フラグを調べます。 0 以外の正のレートは充電を示します。負のレートは放電を示します。 一部のバッテリでは、放電率のみが報告されます。 料金が利用できない場合、このメンバーはBATTERY_UNKNOWN_RATE。 バッテリまたは電源の状態が変わると、レートが使用可能になる可能性があります。

注釈

この構造体の PowerState メンバーのBATTERY_CRITICAL フラグは、ハードウェアの "バッテリクリティカル" 状態を示します。 このクリティカル レベルは、"重大なバッテリー アラーム" のユーザーではなく、バッテリー製造元によって設定されます。これは一般に、バッテリ システムがバッテリが完全に消耗し、描画される電力が期待を超えていると計算したことを意味します。

要件

こちらもご覧ください

BATTERY_INFORMATION

IOCTL_BATTERY_QUERY_STATUS