BATTERY_SET_INFORMATION構造体
設定するバッテリ情報が含まれます。 この構造体は、 IOCTL_BATTERY_SET_INFORMATION コントロール コードと共に使用されます。
構文
typedef struct _BATTERY_SET_INFORMATION {
ULONG BatteryTag;
BATTERY_SET_INFORMATION_LEVEL InformationLevel;
UCHAR Buffer[1];
} BATTERY_SET_INFORMATION, *PBATTERY_SET_INFORMATION;
メンバー
-
BatteryTag
-
バッテリーの現在のバッテリー タグ。 タグに一致するバッテリーの情報は、返されるだけです。 この値がバッテリの現在のタグと一致しない場合は常に、IOCTL 要求は ERROR_FILE_NOT_FOUND で完了します。これは、呼び出し元に対して、バッテリーに タグが付いているバッテリーが存在しないことを示します。 呼び出し元は 、IOCTL_BATTERY_QUERY_TAG 操作を使用して、新しくインストールされたバッテリーのタグが存在する場合は、そのタグを決定することを選択できます。 (詳細については、「 バッテリー タグ 」を参照してください)。
クエリ情報要求が行われると、この値が検証されます。 さらに、この値が変更されている間に要求が進行中の場合、要求はERROR_FILE_NOT_FOUNDの状態で中止されます。
-
InformationLevel
-
設定するバッテリー情報。 Buffer メンバー内のデータの種類は、このメンバーの値によって異なります。 このメンバーには、次のいずれかの値を指定できます。
値 説明 - BatteryCharge
- 1
この時点でバッテリーを充電する必要があることをユーザーが要求したことをバッテリー デバイスに通知します。 たとえば、スマート バッテリー/充電器/セレクターを使用すると、アプリケーションは一度に 1 つのバッテリーを充電できます。 この構造体の Buffer メンバーは無視されます。 - BatteryCriticalBias
- 0
バッテリのクリティカル バイアス調整を設定します。 この値は通常ソフトウェアによって変更され、メンテナンス機能としてのみインターフェイスに存在することは想定されていないことに注意してください。 すべての電池がこのような設定を維持できるわけではありません。バッテリー情報を読んで、バッテリーが設定を受け入れたことを確認する必要があります。 - BatteryDischarge
- 2
ユーザーがこの時点でバッテリを放電することを要求したことをバッテリ デバイスに通知します。 たとえば、これは、ユーザーが現在システムに電源を供給するバッテリーを示すために使用できます。 この構造体の Buffer メンバーは無視されます。 -
バッファー
-
設定するバッテリー情報。 データは InformationLevel の値によって異なります。
注釈
BATTERY_SET_INFORMATION構造体は可変長構造体であり、構造体に含める情報に適したサイズのバッファーを割り当てる必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows XP [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows Server 2003 [デスクトップ アプリのみ] |
| Header |
|