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

BATTERY_INFORMATION

構造体
サイズx64: 36 バイト / x86: 36 バイト

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

フィールド

フィールドサイズx64x86説明
CapabilitiesDWORD4+0+0バッテリの機能フラグ(BATTERY_CAPACITY_RELATIVE等)である。
TechnologyBYTE1+4+4バッテリ技術。0で非充電式、1で充電式を示す。
ReservedBYTE3+5+5予約フィールドである。0となる。
ChemistryBYTE4+8+8バッテリの化学組成を表す4文字コード("LION"等)である。
DesignedCapacityDWORD4+12+12設計上の満充電容量(mWh)である。
FullChargedCapacityDWORD4+16+16現在の満充電容量(mWh)である。劣化で減少する。
DefaultAlert1DWORD4+20+20低残量警告1の既定しきい値(mWh)である。
DefaultAlert2DWORD4+24+24低残量警告2の既定しきい値(mWh)である。
CriticalBiasDWORD4+28+28容量計算に加味する重要バイアス値(mWh)である。
CycleCountDWORD4+32+32バッテリの充放電サイクル数である。

各言語での定義

#include <windows.h>

// BATTERY_INFORMATION  (x64 36 / x86 36 バイト)
typedef struct BATTERY_INFORMATION {
    DWORD Capabilities;
    BYTE Technology;
    BYTE Reserved[3];
    BYTE Chemistry[4];
    DWORD DesignedCapacity;
    DWORD FullChargedCapacity;
    DWORD DefaultAlert1;
    DWORD DefaultAlert2;
    DWORD CriticalBias;
    DWORD CycleCount;
} BATTERY_INFORMATION;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct BATTERY_INFORMATION
{
    public uint Capabilities;
    public byte Technology;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 3)] public byte[] Reserved;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 4)] public byte[] Chemistry;
    public uint DesignedCapacity;
    public uint FullChargedCapacity;
    public uint DefaultAlert1;
    public uint DefaultAlert2;
    public uint CriticalBias;
    public uint CycleCount;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure BATTERY_INFORMATION
    Public Capabilities As UInteger
    Public Technology As Byte
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=3)> Public Reserved() As Byte
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=4)> Public Chemistry() As Byte
    Public DesignedCapacity As UInteger
    Public FullChargedCapacity As UInteger
    Public DefaultAlert1 As UInteger
    Public DefaultAlert2 As UInteger
    Public CriticalBias As UInteger
    Public CycleCount As UInteger
End Structure
import ctypes
from ctypes import wintypes

class BATTERY_INFORMATION(ctypes.Structure):
    _fields_ = [
        ("Capabilities", wintypes.DWORD),
        ("Technology", ctypes.c_ubyte),
        ("Reserved", ctypes.c_ubyte * 3),
        ("Chemistry", ctypes.c_ubyte * 4),
        ("DesignedCapacity", wintypes.DWORD),
        ("FullChargedCapacity", wintypes.DWORD),
        ("DefaultAlert1", wintypes.DWORD),
        ("DefaultAlert2", wintypes.DWORD),
        ("CriticalBias", wintypes.DWORD),
        ("CycleCount", wintypes.DWORD),
    ]
#[repr(C)]
pub struct BATTERY_INFORMATION {
    pub Capabilities: u32,
    pub Technology: u8,
    pub Reserved: [u8; 3],
    pub Chemistry: [u8; 4],
    pub DesignedCapacity: u32,
    pub FullChargedCapacity: u32,
    pub DefaultAlert1: u32,
    pub DefaultAlert2: u32,
    pub CriticalBias: u32,
    pub CycleCount: u32,
}
import "golang.org/x/sys/windows"

type BATTERY_INFORMATION struct {
	Capabilities uint32
	Technology byte
	Reserved [3]byte
	Chemistry [4]byte
	DesignedCapacity uint32
	FullChargedCapacity uint32
	DefaultAlert1 uint32
	DefaultAlert2 uint32
	CriticalBias uint32
	CycleCount uint32
}
type
  BATTERY_INFORMATION = record
    Capabilities: DWORD;
    Technology: Byte;
    Reserved: array[0..2] of Byte;
    Chemistry: array[0..3] of Byte;
    DesignedCapacity: DWORD;
    FullChargedCapacity: DWORD;
    DefaultAlert1: DWORD;
    DefaultAlert2: DWORD;
    CriticalBias: DWORD;
    CycleCount: DWORD;
  end;
const BATTERY_INFORMATION = extern struct {
    Capabilities: u32,
    Technology: u8,
    Reserved: [3]u8,
    Chemistry: [4]u8,
    DesignedCapacity: u32,
    FullChargedCapacity: u32,
    DefaultAlert1: u32,
    DefaultAlert2: u32,
    CriticalBias: u32,
    CycleCount: u32,
};
type
  BATTERY_INFORMATION {.bycopy.} = object
    Capabilities: uint32
    Technology: uint8
    Reserved: array[3, uint8]
    Chemistry: array[4, uint8]
    DesignedCapacity: uint32
    FullChargedCapacity: uint32
    DefaultAlert1: uint32
    DefaultAlert2: uint32
    CriticalBias: uint32
    CycleCount: uint32
struct BATTERY_INFORMATION
{
    uint Capabilities;
    ubyte Technology;
    ubyte[3] Reserved;
    ubyte[4] Chemistry;
    uint DesignedCapacity;
    uint FullChargedCapacity;
    uint DefaultAlert1;
    uint DefaultAlert2;
    uint CriticalBias;
    uint CycleCount;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; BATTERY_INFORMATION サイズ: 36 バイト(x64)
dim st, 9    ; 4byte整数×9(構造体サイズ 36 / 4 切り上げ)
; Capabilities : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; Technology : BYTE (+4, 1byte)  poke st,4,値  /  値 = peek(st,4)
; Reserved : BYTE (+5, 3byte)  varptr(st)+5 を基点に操作(3byte:入れ子/配列)
; Chemistry : BYTE (+8, 4byte)  varptr(st)+8 を基点に操作(4byte:入れ子/配列)
; DesignedCapacity : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; FullChargedCapacity : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; DefaultAlert1 : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; DefaultAlert2 : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; CriticalBias : DWORD (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; CycleCount : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global BATTERY_INFORMATION
    #field int Capabilities
    #field byte Technology
    #field byte Reserved 3
    #field byte Chemistry 4
    #field int DesignedCapacity
    #field int FullChargedCapacity
    #field int DefaultAlert1
    #field int DefaultAlert2
    #field int CriticalBias
    #field int CycleCount
#endstruct

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