BATTERY_WAIT_STATUS 结构
包含有关要检索电池状态的条件的信息。 此结构由 IOCTL_BATTERY_QUERY_STATUS 控件代码使用。
语法
typedef struct _BATTERY_WAIT_STATUS {
ULONG BatteryTag;
ULONG Timeout;
ULONG PowerState;
ULONG LowCapacity;
ULONG HighCapacity;
} BATTERY_WAIT_STATUS, *PBATTERY_WAIT_STATUS;
成员
-
BatteryTag
-
电池的当前电池标记。 只能返回与标记匹配的电池的信息。 每当此值与电池的当前标记不匹配时， DeviceIoControl 操作将失败，错误代码为 ERROR_FILE_NOT_FOUND，这向调用方指示不再安装有标记的电池。调用方可以选择使用 IOCTL_BATTERY_QUERY_TAG 操作来确定新安装的电池的标记， 如果有。 此外，如果在移除电池或更改标记时请求正在进行，则操作将中止，状态为 ERROR_FILE_NOT_FOUND。 (有关详细信息，请参阅 电池标记 。)
-
超时
-
请求在完成之前等待 PowerState、 LowCapacity 和 HighCapacity 成员指定的条件的毫秒数。 值 -1 表示请求将无限期等待条件得到满足。 值为零表示将立即返回请求的电池信息，而不考虑其他条件。 任何其他值指示请求应等待该时间长度，或直到满足任何其他条件之一。
如果计算机已进入睡眠模式，时钟将继续运行，但耗尽计数不会唤醒计算机。 如果在唤醒计算机时计数已用完，并且满足其他条件，则唤醒时将立即返回调用。
-
PowerState
-
零位、一个或多个以下状态位，指示电池的状态。 它与 BATTERY_STATUS 结构的 PowerState 成员相同。
值 含义 - BATTERY_CHARGING
- 0x00000004
指示电池当前正在充电。 - BATTERY_CRITICAL
- 0x00000008
指示电池即将发生故障。 有关详细信息，请参阅备注部分。 - BATTERY_DISCHARGING
- 0x00000002
指示电池当前正在放电。 - BATTERY_POWER_ON_LINE
- 0x00000001
指示电池可以访问交流电源。 -
LowCapacity
-
当前电池容量，以 mWh (或相对) 为单位。 此值与 BATTERY_STATUS 结构的 Capacity 成员相同。
-
HighCapacity
-
当前电池容量，以 mWh (或相对) 为单位。 此值与 BATTERY_STATUS 结构的 Capacity 成员相同。
备注
电池信息请求将推迟，直到发生以下情况之一：
- 如果超时值不是 -1) ，则超时 (过期。
- 电池的当前状态与 PowerState 不匹配。
- 电池的容量低于 LowCapacity。
- 电池的容量高于 HighCapacity。
- 电池标记更改。
如果满足上述任一条件，则收集数据并返回操作。 这允许应用程序监视典型的动态电池信息，而无需轮询设备。
在使用两种容量条件之一之前，请确保电池支持它们，方法是使用超时为零 的IOCTL_BATTERY_QUERY_STATUS 控制代码。 检查结果以确定 容量 成员是否受支持， (即，而不是BATTERY_UNKNOWN_CAPACITY) 。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 |
Windows XP [仅限桌面应用] |
| 最低受支持的服务器 |
Windows Server 2003 [仅限桌面应用] |
| 标头 |
|