Advanced Configuration and Power Interface Specification

Power Source and Power Meter Devices
Return Value:
A Package containing the battery information as described below
Return Value Information:
_BIF returns a package in the format below
Package {
Power Unit
Design Capacity
Last Full Charge Capacity
Battery Technology
Design Voltage
Design Capacity of Warning
Design Capacity of Low
Battery Capacity Granularity 1
Battery Capacity Granularity 2
Model Number
Serial Number
Battery Type
OEM Information
}
// Integer (DWORD)
// Integer (DWORD)
// Integer (DWORD)
// Integer (DWORD)
// Integer (DWORD)
// Integer (DWORD)
// Integer (DWORD)
// Integer (DWORD)
// Integer (DWORD)
// String (ASCIIZ)
// String (ASCIIZ)
// String (ASCIIZ)
// String (ASCIIZ)
Table 10-273 BIF Return Package Values
Field Format Description
Power Unit Integer
(DWORD)
Indicates the units used by the battery to report its capacity and charge/
discharge rate information to the OS.
0x00000000 – Capacity information is reported in [mWh] and charge/
discharge rate information in [mW].
0x00000001 – Capacity information is reported in [mAh] and charge/
discharge rate information in [mA].
Design Capacity
Last Full Charge
Capacity
Battery
Technology
Design Voltage
Design capacity
of Warning
Integer
(DWORD)
Integer
(DWORD)
Integer
(DWORD)
Integer
(DWORD)
Integer
(DWORD)
Battery’s design capacity. Design Capacity is the nominal capacity of a
new battery. The Design Capacity value is expressed as power [mWh] or
current [mAh] depending on the Power Unit value.
0x000000000 – 0x7FFFFFFF (in [mWh] or [mAh] )
0xFFFFFFFF – Unknown design capacity
Predicted battery capacity when fully charged. The Last Full Charge
Capacity value is expressed as power (mWh) or current (mAh) depending
on the Power Unit value.
0x000000000h – 0x7FFFFFFF (in [mWh] or [mAh] )
0xFFFFFFFF – Unknown last full charge capacity
0x00000000 – Primary (for example, non-rechargeable)
0x00000001 – Secondary (for example, rechargeable)
Nominal voltage of a new battery.
0x000000000 – 0x7FFFFFFF in [mV]
0xFFFFFFFF – Unknown design voltage
OEM-designed battery warning capacity. See Section 3.9.4, “Low
Battery Levels.”
0x000000000 – 0x7FFFFFFF in [mWh] or [mAh]
Version 6.0 571