共用方式為

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 會傳回下列其中一項：

傳回碼 Description
STATUS_SUCCESS
 目前已安裝 BatteryTag所指定的電池。
STATUS_NO_SUCH_DEVICE
 BatteryTag指定的電池不存在。

備註

電池類別驅動程式會呼叫 BatteryMiniQueryStatus 以取得電池的狀態資訊。 狀態資訊包括電池的電源狀態、容量、電壓，以及要求時流動的目前數量。

如果迷你類別驅動程式未提供功能完整的 BatteryMiniSetStatusNotify 和 BatteryMiniDisableStatusNotify 常式，電池類別驅動程式會定期呼叫 BatteryMiniQueryStatus ，但不常輪詢電池的狀態。 否則，類別驅動程式會在迷你類別驅動程式收到電池狀態變更的通知後呼叫此常式。

在回報非常低的電池 (BATTERY_DISCHARGING 和BATTERY_CRITICAL) 之前，迷你類別驅動程式應該先確定問題是合法的 (，而不是) 的暫時狀態，如果是的話，應該嘗試解決問題。 可能的解決方案可能包括切換至 AC 電源或另一個電池。 當迷你類別驅動程式回報電池是嚴重且充電時，系統會假設電池故障即將發生，並準備關機。

規格需求

   
目標平台 桌面
標頭 batclass.h (包括 Batclass.h)
IRQL PASSIVE_LEVEL

另請參閱

BatteryClassStatusNotify

BatteryMiniDisableStatusNotify

BatteryMiniSetStatusNotify