BATTERY_QUERY_INFORMATION構造体
バッテリー クエリ情報が含まれます。 この構造体は、 IOCTL_BATTERY_QUERY_INFORMATION コントロール コードと共に使用され、返される情報の種類を指定します。
構文
typedef struct _BATTERY_QUERY_INFORMATION {
ULONG BatteryTag;
BATTERY_QUERY_INFORMATION_LEVEL InformationLevel;
LONG AtRate;
} BATTERY_QUERY_INFORMATION, *PBATTERY_QUERY_INFORMATION;
メンバー
-
BatteryTag
-
バッテリーの現在のバッテリー タグ。 タグに一致するバッテリーの情報のみを返すことができます。 この値がバッテリの現在のタグと一致しない場合は常に、IOCTL 要求は ERROR_FILE_NOT_FOUNDで完了します。 これは、タグに関連付けられているバッテリーが長く存在することを呼び出し元に示します。 呼び出し元は 、IOCTL_BATTERY_QUERY_TAG 操作を使用して、新しくインストールされたバッテリーのタグが存在する場合は、そのタグを決定することを選択できます。 (詳細については、「 バッテリー タグ 」を参照してください)。
クエリ情報要求が行われると、この値が検証されます。 さらに、この値が変更されている間に要求が進行中の場合、要求はERROR_FILE_NOT_FOUNDの状態で中止されます。
-
InformationLevel
-
クエリ対象のバッテリ情報のレベル。 IOCTL によって返されるデータは、この値によって異なります。 このメンバーには、次のいずれかの値を指定できます。
値 説明 - BatteryDeviceName
- 4
バッテリーの名前を含む Null で終わる Unicode 文字列。 - BatteryEstimatedTime
- 3
バッテリーの推定実行時間を秒単位で指定する ULONG 。 BATTERY_QUERY_INFORMATION構造体の AtRate メンバーに設けられたドレインの速度が 0 の場合、この計算はドレインの現在のレートに基づいています。 AtRate が 0 以外の場合、返される時間は、指定されたレートに対して予想される実行時間です。 推定時間が不明な場合 (たとえば、バッテリが放電せず、 指定された AtRate が 0 の場合)、戻り値はBATTERY_UNKNOWN_TIME。 この値は、一部のバッテリ システムでは正確ではなく、現在の電力使用量によって大きく異なる場合があり、ディスクの動作やその他の要因の影響を受ける可能性があることに注意してください。 この値の変更に関する通知メカニズムはありません。 - BatteryGranularityInformation
- 1
BATTERY_REPORTING_SCALE構造体の配列。4 つ以下のエントリはありません。 - BatteryInformation
- 0
BATTERY_INFORMATION構造体。 - BatteryManufactureDate
- 5
BATTERY_MANUFACTURE_DATE構造体。 - BatteryManufactureName
- 6
バッテリの製造元の名前を指定する Null で終わる Unicode 文字列。 - BatterySerialNumber
- 8
バッテリのシリアル番号を指定する Null で終わる Unicode 文字列。 - BatteryTemperature
- 2
バッテリーの現在の温度をケルビン度の 10 分の 1 で指定する ULONG 。 - BatteryUniqueID
- 7
バッテリーを一意に識別する Null で終わる Unicode 文字列。 この値は、特定のバッテリーを追跡するために使用できます。 スマート バッテリーの場合、この ID は、製造元の名前、デバイス名、製造日、およびシリアル番号の印刷可能な表現を連結したものです。
この値は、ユーザーに表示されるものではありません。 -
AtRate
-
このメンバーは、 InformationLevel が BatteryEstimatedTime の場合にのみ使用されます。
このメンバーが 0 以外の場合は、個々のバッテリの BatteryEstimatedTime のバッテリが放電されるまでの時間を計算するために使用されるドレインの速度です。 これは mW で指定する必要があり、バッテリの放電速度を表す負の値である必要があります。
注釈
電池に関する一部の情報はオプションであり、一部の電池では意味がない場合があります。 要求された特定の種類のデータが現在のバッテリで使用できない場合は、ERROR_INVALID_FUNCTIONが返されます。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント |
Windows XP [デスクトップ アプリのみ] |
サポートされている最小のサーバー |
Windows Server 2003 [デスクトップ アプリのみ] |
Header |
|