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
通知電池裝置使用者目前應該充電電池。 例如，使用智慧型電池/充電/選取器，應用程式可以一次充電一個電池。 忽略這個 結構的 Buffer 成員。 - BatteryCriticalBias
- 0
設定電池的重大偏差調整。 請注意，這個值通常會由軟體變更，而且只會以維護功能的形式出現在介面中。 並非所有電池都可以維護這類設定，而且應該讀取電池資訊以確認電池已接受設定。 - BatteryDischarge
- 2
通知電池裝置使用者目前已要求電池解除充電。 例如，這可用來指出使用者目前想要為系統提供電源的電池。 忽略這個 結構的 Buffer 成員。 -
Buffer
-
要設定的電池資訊。 資料取決於 InformationLevel的值。
備註
BATTERY_SET_INFORMATION結構是可變長度的結構，您必須配置適合大小的緩衝區，以便結構中包含資訊。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows XP [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows Server 2003 [僅限桌面應用程式] |
| 標頭 |
|