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+0AC電源の接続状態。0=オフライン,1=オンライン,255=不明。
BatteryFlagBYTE1+1+1バッテリ充電状態のフラグ。255で状態不明を表す。
BatteryLifePercentBYTE1+2+2バッテリ残量の割合。0〜100%、255で不明。
SystemStatusFlagBYTE1+3+3システムステータスフラグ。バッテリセーバー有効等。
BatteryLifeTimeDWORD4+4+4残り使用可能時間。秒単位、-1(0xFFFFFFFF)で不明。
BatteryFullLifeTimeDWORD4+8+8満充電時の総使用可能時間。秒単位、-1で不明。

各言語での定義

#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