電源設定 GUID

  • 發行項

電源設定 GUID可識別電源變更事件。 本主題列出應用程式最實用之通知的電源設定 GUID。 應用程式應該註冊可能會影響其行為的每個電源變更事件。 每次設定變更時，都會傳送通知。

Power setting GUID定義於 WinNT.h 中。

GUID_ACDC_POWER_SOURCE （5D3E9A59-E9D5-4B00-A6BD-FF34FF516548）

系統電源已變更。

Data 成員是 DWORD，具有來自SYSTEM_POWER_CONDITION列舉的值，指出目前的電源來源：

PoAc （0） - 電腦由 AC 電源供電（或類似，例如由 12V 汽車適配卡供電的膝上型電腦）。

PoDc （1） - 電腦由上線電池電源供電。

PoHot （2） - 電腦由短期電源提供電源，例如 UPS 裝置。

GUID_BATTERY_PERCENTAGE_REMAINING （A7AD8041-B45A-4CAE-87A3-EECBB468A9E1）

剩餘的電池容量已變更。 數據粒度會因系統而異，但最佳數據粒度為 1%。

數據成員是 DWORD，表示目前剩餘的電池容量為 0 到 100 的百分比。

GUID_CONSOLE_DISPLAY_STATE （6FE69556-704A-47A0-8F24-C28D936FDA47）

目前監視器的顯示狀態已變更。

Windows 7、Windows Server 2008 R2、Windows Vista 和 Windows Server 2008： 此通知可從 Windows 8 和 Windows Server 2012 開始提供。

Data 成員是 DWORD，具有來自 MONITOR_DISPLAY_STATE 列舉的值：

PowerMonitorOff （0） - 顯示器已關閉。

PowerMonitorOn （1） - 顯示器開啟。

PowerMonitorDim （2） - 顯示器呈現暗灰色。

GUID_GLOBAL_USER_PRESENCE （786E8A1D-B427-4344-9207-09E70BDCBEA9）

與任何工作階段相關聯的用戶狀態已變更。 這代表系統上所有本機和遠端會話的使用者存在狀態合併狀態。

此通知只會傳送在會話 0 中執行的服務和其他程式。 使用者模式應用程式應該改為註冊 GUID_SESSION_USER_PRESENCE 。

Windows 7、Windows Server 2008 R2、Windows Vista 和 Windows Server 2008： 此通知可從 Windows 8 和 Windows Server 2012 開始提供。

Data 成員是 DWORD，其中包含來自 USER_ACTIVITY_PRESENCE 列舉的下列其中一個值：

PowerUserPresent （0） - 使用者存在於系統上的任何本機或遠端會話中。

PowerUserInactive （2） - 使用者不存在於系統上的任何本機或遠端會話中。

GUID_IDLE_BACKGROUND_TASK （515C31D8-F734-163D-A0FD-11A08C91E8F1）

系統忙碌中。 這表示系統不會在不遠的將來進入閑置狀態，而且目前時間是元件執行背景或閑置工作的好時機，否則計算機無法進入閑置狀態。

當系統能夠進入閑置狀態時，不會有任何通知。 閑置背景工作通知不會指出使用者是否存在在計算機上。

數據成員沒有資訊，而且可以忽略。

GUID_LIDSWITCH_STATE_CHANGE （BA3E0F4D-B817-4094-A2D1-D56379E6A0F3）

蓋子的狀態已經改變（開放與封閉）。 在找到蓋子裝置並知道其目前狀態之前，將不會呼叫回呼。

0x0 - 蓋子關閉。

0x1 - 蓋子打開。

GUID_MONITOR_POWER_ON （02731015-4510-4526-99E6-E5A17EBD1AEA）

主要系統監視器已開啟或關閉電源。 此通知適用於主動將內容轉譯至顯示裝置的元件，例如媒體視覺效果。 應用程式應該註冊此通知，並在監視器關閉時停止轉譯圖形內容，以減少系統耗電量。

Data 成員是指出目前監視狀態的 DWORD：

0x0 - 監視器已關閉。

0x1 - 監視器已開啟。

Windows 8 和 Windows Server 2012： 新的應用程式應該使用 GUID_CONSOLE_DISPLAY_STATE ，而不是此通知。

GUID_POWER_SAVING_STATUS （E00958C0-C213-4ACE-AC77-FECCED2EEEA5）

省電模式已關閉或開啟，以因應電源狀況的變化。 此通知適用於參與節能的元件。 應用程式應該註冊此通知，並在省電模式開啟時節省電源。

數據成員是 DWORD，表示省電狀態：

0x0 - 省電模式已關閉。

0x1 - 省電模式已開啟。 儘可能節省能源。

如需省電模式的一般資訊，請參閱省電模式（在硬體元件指導方針中）。

GUID_ENERGY_SAVER_STATUS （550E8400-E29B-41D4-A716-446655440000）

重要

這項資訊與發行前版本產品有關，在發行前可能會大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

節能狀態已變更。 此通知適用於參與節能的元件。 註冊此通知的應用程式可以根據哪些節能模式有效節省不同程度的電源。

Data 成員是 DWORD，具有來自ENERGY_SAVER_STATUS列舉的值，表示目前的節能狀態。

ENERGY_SAVER_OFF - 節能器已關閉。

ENERGY_SAVER_STANDARD - 節能器處於標準模式。 如果用戶體驗影響最小，可節省能源。

ENERGY_SAVER_HIGH_SAVINGS - 節能模式處於高節省模式。 儘可能節省能源。

GUID_POWERSCHEME_PERSONALITY （245D8541-3943-4422-B025-13A784F679B7）

現役權力計劃個性已經改變。 所有電源配置都對應到其中一個個性。

數據成員是 GUID，表示新的主動電源配置個性：

GUID_MIN_POWER_SAVINGS （8C5E7FDA-E8BF-4A96-9A85-A6E23A8C635C）

高效能 - 此配置的設計目的是為了節省耗電量而提供最高效能。

GUID_MAX_POWER_SAVINGS （A1841308-3541-4FAB-BC81-F71556F20B4A）

電源節省器 - 此配置的設計目的是為了犧牲系統效能和回應性來節省最大耗電量。

GUID_TYPICAL_POWER_SAVINGS （381B4222-F694-41F0-9685-FF5BB260DF2E）

自動 - 此配置是設計來自動平衡效能和省電量。

GUID_SESSION_DISPLAY_STATUS （2B84C20E-AD23-4DDF-93DB-05FFBD7EFCA5）

與應用程式會話相關聯的顯示已開啟或關閉。

Windows 7、Windows Server 2008 R2、Windows Vista 和 Windows Server 2008： 此通知可從 Windows 8 和 Windows Server 2012 開始提供。

此通知只會傳送至使用者模式應用程式。 在工作階段 0 中執行的服務和其他程式不會收到此通知。

Data 成員是 DWORD，具有來自 MONITOR_DISPLAY_STATE 列舉的值：

PowerMonitorOff （0） - 顯示器已關閉。

PowerMonitorOn （1） - 顯示器開啟。

PowerMonitorDim （2） - 顯示器呈現暗灰色。

注意

在互動式使用者模式會話中執行的所有應用程式都應該使用此設定。 當內核模式應用程式註冊以監視狀態時，應該改用 GUID_CONSOLE_DISPLAY_STATUS 。

GUID_SESSION_USER_PRESENCE （3C0F4548-C03F-4C4D-B9F2-237EDE686376）

與應用程式會話相關聯的用戶狀態已變更。

Windows 7、Windows Server 2008 R2、Windows Vista 和 Windows Server 2008： 此通知可從 Windows 8 和 Windows Server 2012 開始提供。

此通知只會傳送至在互動式會話中執行的使用者模式應用程式。 在工作階段 0 中執行的服務和其他程式應該註冊 GUID_GLOBAL_USER_PRESENCE。

Data 成員是 DWORD，其中包含來自 USER_ACTIVITY_PRESENCE 列舉的下列其中一個值：

PowerUserPresent （0） - 使用者正在提供工作階段的輸入。

PowerUserInactive （2） - 用戶活動逾時已經過，且使用者沒有任何互動。

GUID_SYSTEM_AWAYMODE （98A7F580-01F7-48AA-9C0F-44352C29E5C0）

系統會進入或結束客體模式。

Data 成員是指出目前客流模式狀態的 DWORD：

0x0 - 計算機正在離開模式。

0x1 - 計算機正在進入客機模式。

需求

需求 值
頁首
WinNT.h