次の方法で共有

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 の場合のミリワットのクリティカル バイアス調整。 Level の他の値には使用されません。

戻り値

BatteryMiniSetInformation は、次のいずれかを返します。

リターン コード 説明
STATUS_SUCCESS
 操作が成功しました。
STATUS_NO_SUCH_DEVICE
 バッテリーがありません。
STATUS_NOT_SUPPORTED
 指定されたバッテリーは、要求された操作をサポートしていません。
STATUS_UNSUCCESSFUL
 操作が失敗しました。

注釈

バッテリー クラス ドライバーは BatteryMiniSetInformation を呼び出して、バッテリの充電または放電を開始するように要求します。 また、このルーチンを呼び出して、重大なバイアス値を設定することもできます。

スマート バッテリー充電器/セレクターを使用すると、クラス ドライバーは、充電するバッテリーを選択するように BatteryCharge を 指定し、別のバッテリーの充電を中止する可能性があります。

クラス ドライバーは、システムに電源を供給するバッテリを示す BatteryDischarge を指定します。

重大なバイアス調整は、自動車のガスタンクの予備容量に似ています。 これは、バッテリー容量がゼロとして報告された場合の残りの充電を表します。 クラス ドライバーでは、通常の使用では重要なバイアス値は変更されませんが、このフィールドは、メンテナンス機能としてインターフェイスで提供されます。 すべてのバッテリが重大なバイアス設定を維持できるわけではありません。 このようなバッテリーのミニクラス ドライバーは、STATUS_NOT_SUPPORTEDを返す必要があります。

要件

要件 値
対象プラットフォーム デスクトップ
Header batclass.h (Batclass.h を含む)
IRQL PASSIVE_LEVEL