通过

BCLASS_SET_STATUS_NOTIFY_CALLBACK回调函数 (batclass.h)

  • 项目

BatteryMiniSetStatusNotify 设置电池容量和电源状态级别，类驱动程序需要通知。

语法

BCLASS_SET_STATUS_NOTIFY_CALLBACK BclassSetStatusNotifyCallback;

NTSTATUS BclassSetStatusNotifyCallback(
  [in] PVOID Context,
  [in] ULONG BatteryTag,
  [in] PBATTERY_NOTIFY BatteryNotify
)
{...}

参数

[in] Context

指向由微型类驱动程序为电池设备分配的上下文区域的指针。

[in] BatteryTag

以前由 BatteryMiniQueryTag 返回的电池标记值。

[in] BatteryNotify

指向 BATTERY_NOTIFY 结构的指针。

返回值

BatteryMiniSetStatusNotify 返回下列值之一：

返回代码 说明
STATUS_SUCCESS
 当前已安装电池。
STATUS_NO_SUCH_DEVICE
 不存在电池或给定的电池标记无效。
STATUS_NOT_SUPPORTED
 微型类驱动程序无法区分目标条件。

注解

电池类驱动程序调用微型类驱动程序的 BatteryMiniSetStatusNotify 例程，以设置可接受的电池条件范围的条件。 当电池的容量或电源状态偏离这些条件时，微型类驱动程序必须调用 BatteryClassStatusNotify 来通知类驱动程序。

在 BATTERY_NOTIFY 结构的 PowerState 成员中，类驱动程序指定一个或多个电池电源状态。 每当电池进入不在 PowerState 中的电源状态时，微型类驱动程序都必须通知类驱动程序。

在 BATTERY_NOTIFY 的 LowCapacity 和 HighCapacity 成员中，类驱动程序指定一个容量范围。 当容量超过或低于此范围时，微型类驱动程序必须通知类驱动程序。

某些电池可能无法区分电池类驱动程序要求的精确容量。 如果可能，这些电池的微型类驱动程序应尝试更正错误，以便在电池接近临界状态时通知用户。 否则，此类驱动程序应返回STATUS_NOT_SUPPORTED。

要求

要求 值
目标平台 桌面
标头 batclass.h (包括 Batclass.h)
IRQL PASSIVE_LEVEL

另请参阅

BatteryClassStatusNotify

BatteryMiniDisableStatusNotify