共用方式為

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成員中提供的清空率為零，則此計算是以目前的清空率為基礎。 如果 AtRate 為非零，傳回的時間會是指定速率的預期執行時間。 例如，如果估計時間未知 (，則電池不會放開，而且指定的 AtRate 是零) ，則傳回值會BATTERY_UNKNOWN_TIME。 請注意，在某些電池系統上這個值並不精確，而且可能會因目前的電源使用量而有很大的差異，這可能會受到磁片活動和其他因素的影響。 這個值沒有變更的通知機制。
BatteryGranularityInformation
1
 BATTERY_REPORTING_SCALE結構的陣列，永遠不會超過四個專案。
BatteryInformation
0
 BATTERY_INFORMATION結構。
BatteryManufactureDate
5
 BATTERY_MANUFACTURE_DATE結構。
BatteryManufactureName
6
 以 Null 終止的 Unicode 字串，指定電池製造商的名稱。
BatterySerialNumber
8
 以 Null 終止的 Unicode 字串，指定電池的序號。
BatteryTemperature
2
 ULONG，指定電池目前溫度，以 Kelvin 度 10 秒為單位。
BatteryUniqueID
7
 以 Null 終止的 Unicode 字串，可唯一識別電池。 這個值可用來追蹤特定的電池。 在智慧電池的情況下，此識別碼會是製造商名稱、裝置名稱、製造日期，以及可列印的序號標記法。
此值並非要向使用者顯示。

AtRate

只有在 InformationLevel 為 BatteryEstimatedTime 時，才會使用此成員。

如果這個成員是非零的，則會是清空率，用來計算電池在針對個別電池的 BatteryEstimatedTime 釋放電池之前的時間。 它必須在 mW 中指定，而且必須是負值，才能表示電池計量釋放率。

備註

某些電池的相關資訊是選擇性的，或對於某些電池而言可能沒有意義。 如果目前電池無法使用所要求的特定資料類型，則會傳回ERROR_INVALID_FUNCTION。

規格需求

需求 值
最低支援的用戶端
 Windows XP [僅限傳統型應用程式]
最低支援的伺服器
 Windows Server 2003 [僅限桌面應用程式]
標頭
Poclass.h;
Windows Server 2008 R2、Windows 7、Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP 上的 Batclass.h

另請參閱

BATTERY_INFORMATION

BATTERY_MANUFACTURE_DATE

BATTERY_REPORTING_SCALE

IOCTL_BATTERY_QUERY_INFORMATION

IOCTL_BATTERY_QUERY_TAG