BatteryClassInitializeDevice 関数 (batclass.h)

[アーティクル]
08/22/2023

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 ルーチンでは、ミニクラスドライバーは、渡されたポインターを介してデバイス拡張機能データの読み取りと書き込みを行う必要があります。

ミニクラスドライバーでは、すべての BatteryMiniXxx ルーチンのエントリポイントを指定するBATTERY_MINIPORT_INFO構造体を使用する必要があります。

BatteryClassInitializeDevice がバッテリデバイスを正常に初期化した場合、呼び出し元は BatteryClassUnload 関数を呼び出して、使用されなくなったバッテリデバイスのリソースを解放します。