Win32 API 日本語リファレンス
ホーム › System.Power › SYSTEM_POWER_STATUS

SYSTEM_POWER_STATUS

構造体
📘 Microsoft Learn (日本語) · English
サイズx64: 12 バイト / x86: 12 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールド型サイズx64x86説明
ACLineStatusBYTE1+0+0

AC 電源の状態です。このメンバーには次のいずれかの値を指定できます。

値 意味
0
 オフライン
1
 オンライン
255
 不明な状態
BatteryFlagBYTE1+1+1

バッテリーの充電状態です。このメンバーには次のフラグを 1 つ以上含めることができます。

値 意味
1
 高 — バッテリー残量が 66 パーセントを超えています
2
 低 — バッテリー残量が 33 パーセント未満です
4
 危機的 — バッテリー残量が 5 パーセント未満です
8
 充電中
128
 システムバッテリーがありません
255
 不明な状態 — バッテリーフラグの情報を読み取れません

バッテリーが充電中でなく、バッテリー残量が低と高の間にある場合、値は 0 になります。

BatteryLifePercentBYTE1+2+2残っているバッテリー充電量の割合(パーセント)です。このメンバーには 0 から 100 の範囲の値を指定できます。状態が不明な場合は 255 になります。
SystemStatusFlagBYTE1+3+3

バッテリー節約機能の状態です。省電力に協力するため、バッテリー節約機能がオンのときはリソースを大量に消費する処理を避けてください。この値が変化したときに通知を受け取るには、RegisterPowerSettingNotification 関数を、電源設定 GUID である GUID_POWER_SAVING_STATUS を指定して呼び出します。

値 意味
0
 バッテリー節約機能はオフです。
1
 バッテリー節約機能はオンです。可能な限り省電力に努めてください。
メモ このフラグと GUID_POWER_SAVING_STATUS GUID は Windows 10 で導入されました。このフラグは以前は予約済みで、Reserved1 という名前が付けられており、値は 0 でした。
バッテリー節約機能の一般的な情報については、バッテリー節約機能(ハードウェアコンポーネントガイドライン)を参照してください。
BatteryLifeTimeDWORD4+4+4残りのバッテリー駆動時間(秒単位)です。残り秒数が不明な場合、またはデバイスが AC 電源に接続されている場合は -1 になります。
BatteryFullLifeTimeDWORD4+8+8満充電時のバッテリー駆動時間(秒単位)です。満充電時の駆動時間が不明な場合、またはデバイスが AC 電源に接続されている場合は -1 になります。

公式ドキュメント

システムの電源状態に関する情報を格納します。

解説(Remarks)

システムは、BatteryLifeTime と BatteryLifePercent に基づく計算によって BatteryFullLifeTime を推定することしかできません。スマートバッテリーサブシステムがない場合、この値は実用に足るほど正確でないことがあります。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// SYSTEM_POWER_STATUS  (x64 12 / x86 12 バイト)
typedef struct SYSTEM_POWER_STATUS {
    BYTE ACLineStatus;
    BYTE BatteryFlag;
    BYTE BatteryLifePercent;
    BYTE SystemStatusFlag;
    DWORD BatteryLifeTime;
    DWORD BatteryFullLifeTime;
} SYSTEM_POWER_STATUS;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct SYSTEM_POWER_STATUS
{
    public byte ACLineStatus;
    public byte BatteryFlag;
    public byte BatteryLifePercent;
    public byte SystemStatusFlag;
    public uint BatteryLifeTime;
    public uint BatteryFullLifeTime;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure SYSTEM_POWER_STATUS
    Public ACLineStatus As Byte
    Public BatteryFlag As Byte
    Public BatteryLifePercent As Byte
    Public SystemStatusFlag As Byte
    Public BatteryLifeTime As UInteger
    Public BatteryFullLifeTime As UInteger
End Structure
import ctypes
from ctypes import wintypes

class SYSTEM_POWER_STATUS(ctypes.Structure):
    _fields_ = [
        ("ACLineStatus", ctypes.c_ubyte),
        ("BatteryFlag", ctypes.c_ubyte),
        ("BatteryLifePercent", ctypes.c_ubyte),
        ("SystemStatusFlag", ctypes.c_ubyte),
        ("BatteryLifeTime", wintypes.DWORD),
        ("BatteryFullLifeTime", wintypes.DWORD),
    ]
#[repr(C)]
pub struct SYSTEM_POWER_STATUS {
    pub ACLineStatus: u8,
    pub BatteryFlag: u8,
    pub BatteryLifePercent: u8,
    pub SystemStatusFlag: u8,
    pub BatteryLifeTime: u32,
    pub BatteryFullLifeTime: u32,
}
import "golang.org/x/sys/windows"

type SYSTEM_POWER_STATUS struct {
	ACLineStatus byte
	BatteryFlag byte
	BatteryLifePercent byte
	SystemStatusFlag byte
	BatteryLifeTime uint32
	BatteryFullLifeTime uint32
}
type
  SYSTEM_POWER_STATUS = record
    ACLineStatus: Byte;
    BatteryFlag: Byte;
    BatteryLifePercent: Byte;
    SystemStatusFlag: Byte;
    BatteryLifeTime: DWORD;
    BatteryFullLifeTime: DWORD;
  end;
const SYSTEM_POWER_STATUS = extern struct {
    ACLineStatus: u8,
    BatteryFlag: u8,
    BatteryLifePercent: u8,
    SystemStatusFlag: u8,
    BatteryLifeTime: u32,
    BatteryFullLifeTime: u32,
};
type
  SYSTEM_POWER_STATUS {.bycopy.} = object
    ACLineStatus: uint8
    BatteryFlag: uint8
    BatteryLifePercent: uint8
    SystemStatusFlag: uint8
    BatteryLifeTime: uint32
    BatteryFullLifeTime: uint32
struct SYSTEM_POWER_STATUS
{
    ubyte ACLineStatus;
    ubyte BatteryFlag;
    ubyte BatteryLifePercent;
    ubyte SystemStatusFlag;
    uint BatteryLifeTime;
    uint BatteryFullLifeTime;
}

HSP用 定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; SYSTEM_POWER_STATUS サイズ: 12 バイト(x64)
dim st, 3    ; 4byte整数×3(構造体サイズ 12 / 4 切り上げ)
; ACLineStatus : BYTE (+0, 1byte)  poke st,0,値  /  値 = peek(st,0)
; BatteryFlag : BYTE (+1, 1byte)  poke st,1,値  /  値 = peek(st,1)
; BatteryLifePercent : BYTE (+2, 1byte)  poke st,2,値  /  値 = peek(st,2)
; SystemStatusFlag : BYTE (+3, 1byte)  poke st,3,値  /  値 = peek(st,3)
; BatteryLifeTime : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; BatteryFullLifeTime : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global SYSTEM_POWER_STATUS
    #field byte ACLineStatus
    #field byte BatteryFlag
    #field byte BatteryLifePercent
    #field byte SystemStatusFlag
    #field int BatteryLifeTime
    #field int BatteryFullLifeTime
#endstruct

stdim st, SYSTEM_POWER_STATUS        ; NSTRUCT 変数を確保
st->ACLineStatus = 100
mes "ACLineStatus=" + st->ACLineStatus