共用方式為

BCLASS_SET_INFORMATION_CALLBACK batclass.h (回呼函式)

  • 發行項

BatteryMiniSetInformation 要求電池進入充電或卸除狀態，或設定電池的嚴重偏差值。

語法

BCLASS_SET_INFORMATION_CALLBACK BclassSetInformationCallback;

NTSTATUS BclassSetInformationCallback(
  [in] PVOID Context,
  [in] ULONG BatteryTag,
  [in] BATTERY_SET_INFORMATION_LEVEL Level,
  [in] PVOID Buffer
)
{...}

參數

[in] Context

迷你類別驅動程式為電池裝置配置的內容區域指標。

[in] BatteryTag

BatteryMiniQueryTag 先前傳回的電池標記值。

[in] Level

下列其中一個值：BatteryCriticalBias、BatteryCharge 或 BatteryDischarge。

[in] Buffer

如果 Level 為 BatteryCriticalBias，則 milliwatts 中的重大偏差調整。 不適用於 Level 的其他值。

傳回值

BatteryMiniSetInformation 會傳回下列其中一項：

傳回碼 Description
STATUS_SUCCESS
 作業成功。
STATUS_NO_SUCH_DEVICE
 沒有電池存在。
STATUS_NOT_SUPPORTED
 指定的電池不支援要求的作業。
STATUS_UNSUCCESSFUL
 作業失敗。

備註

電池類別驅動程式會呼叫 BatteryMiniSetInformation 來要求電池開始充電或充電。 它也可以呼叫這個例程來設定重大偏差值。

使用智慧型手機充電/選取器，類別驅動程式會指定 BatteryCharge 來選取要充電的電池，可能會停止另一個電池的充電。

類別驅動程式會指定 BatteryDischarge ，以指出哪個電池應該為系統提供電源。

重大偏差調整類似於汽車中油箱的保留容量。 當電池容量回報為零時，它代表剩餘的費用。 雖然類別驅動程式不會在正常使用中變更重大偏差值，但介面中會提供此字段作為維護功能。 並非所有電池都可以維持重大偏差設定。 這類電池的迷你類別驅動程式應該會傳回STATUS_NOT_SUPPORTED。

規格需求

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