BatteryClassInitializeDevice 函数 (batclass.h)

BatteryClassInitializeDevice 例程初始化类驱动程序的新电池设备。

语法

NTSTATUS BATTERYCLASSAPI BatteryClassInitializeDevice(
  [in]  PBATTERY_MINIPORT_INFO MiniportInfo,
  [out] PVOID                  *ClassData
);

[in] MiniportInfo

指向 BATTERY_MINIPORT_INFO 结构的指针。

[out] ClassData

指向 BatteryClassInitializeDevice 返回句柄的位置的指针，该句柄将在后续调用 BatteryMiniXxx 例程时使用。

BatteryClassInitializeDevice 返回STATUS_SUCCESS，或者，如果没有足够的内存可用于存储电池小类数据，则返回STATUS_INSUFFICIENT_RESOURCES。

电池微型类驱动程序必须调用 BatteryClassInitializeDevice 来注册每个电池设备，并将有关设备和微型类驱动程序的数据传递给电池类驱动程序。

应在设备初始化过程中调用此例程，通常从微型类驱动程序的 AddDevice 例程调用。

BATTERY_MINIPORT_INFO 结构的 Context 成员指向类和微型类驱动程序维护有关电池设备及其驱动程序的信息的区域。上下文区域通常包含 FDO 中的可分页设备扩展，还可以包含驱动程序编写器自行决定的其他信息。

类驱动程序将指针传递到对电池微型类驱动程序例程的调用中的上下文区域， (BatteryMiniXxx 例程) 。在其 BatteryMiniXxx 例程中，微型类驱动程序应通过传入的指针读取和写入设备扩展数据。

微型类驱动程序必须使用 BATTERY_MINIPORT_INFO 结构为所有 BatteryMiniXxx 例程提供入口点。

如果 BatteryClassInitializeDevice 成功初始化电池设备，则调用方负责调用 BatteryClassUnload 函数，以便在电池设备不再使用时释放其资源。