BCLASS_QUERY_STATUS_CALLBACK回调函数 (batclass.h)
BatteryMiniQueryStatus 返回有关给定电池设备的状态信息。
语法
BCLASS_QUERY_STATUS_CALLBACK BclassQueryStatusCallback;
NTSTATUS BclassQueryStatusCallback(
[in] PVOID Context,
[in] ULONG BatteryTag,
[out] PBATTERY_STATUS BatteryStatus
)
{...}
参数
[in] Context
指向由微型类驱动程序为电池设备分配的上下文区域的指针。
[in] BatteryTag
以前由 BatteryMiniQueryTag 返回的电池标记值。
[out] BatteryStatus
指向 BATTERY_STATUS 结构的指针，其中微型类驱动程序返回信息。
返回值
BatteryMiniQueryStatus 返回下列值之一：
| 返回代码 | 说明 |
|---|---|
|
目前已安装 BatteryTag 指定的电池。 |
|
由 BatteryTag 指定的电池不存在。 |
注解
电池类驱动程序调用 BatteryMiniQueryStatus 以获取有关电池的状态信息。 状态信息包括电池的电源状态、容量、电压以及请求时流动的电流量。
如果微型类驱动程序不提供功能齐全的 BatteryMiniSetStatusNotify 和 BatteryMiniDisableStatusNotify 例程，电池类驱动程序会定期调用 BatteryMiniQueryStatus ，以轮询电池的状态。 否则，类驱动程序在微型类驱动程序通知其电池状态发生更改后调用此例程。
在报告电池 (BATTERY_DISCHARGING 和BATTERY_CRITICAL) 严重不足之前，微型类驱动程序应确保该问题是合法的 (，而不是) 暂时性状态，如果是这样，应尝试解决问题。 可能的解决方案可能包括切换到交流电源或其他电池。 当微型类驱动程序报告电池处于关键状态并正在充电时，系统会假设电池故障迫在眉睫，并准备关闭。
要求
| 目标平台 | 桌面 |
| 标头 | batclass.h (包括 Batclass.h) |
| IRQL | PASSIVE_LEVEL |