PowerReadSettingAttributes 関数 (powrprof.h)

  • [アーティクル]

指定した電源設定の現在の属性を返します。 SubGroupGuid パラメーターが NULL の場合、PowerSettingGuid の属性が返されます。 PowerSettingGuid パラメーターが NULL の場合、SubGroupGuid の属性が返されます。 SubGroupGuid パラメーターと PowerSettingGuid パラメーターの両方が有効な場合、戻り値はサブグループの属性と電源設定の組み合わせ (ビットごとの OR) になります。

構文

DWORD PowerReadSettingAttributes(
  [in] const GUID *SubGroupGuid,
  [in] const GUID *PowerSettingGuid
);

パラメーター

[in] SubGroupGuid

電源設定のサブグループ。 このパラメーターには、WinNT.h で定義されている次のいずれかの値を指定できます。 NO_SUBGROUP_GUIDを使用して、既定の電源スキームを参照します。

これらの値は、Windows に含まれるサブグループ値です。

値 意味
NO_SUBGROUP_GUID
fea3413e-7e05-4911-9a71-700331f1c294
 このサブグループの設定は、既定の電源スキームの一部です。
GUID_DISK_SUBGROUP
0012ee47-9041-4b5d-9b77-535fba8b1442
 このサブグループの設定は、システムのハード ディスク ドライブの電源管理構成を制御します。
GUID_SYSTEM_BUTTON_SUBGROUP
4f971e89-eebd-4455-a8de-9e59040e7347
 このサブグループの設定は、システム電源ボタンの構成を制御します。
GUID_PROCESSOR_SETTINGS_SUBGROUP
54533251-82be-4824-96c1-47b60b740d00
 このサブグループの設定は、プロセッサの電源管理機能の構成を制御します。
GUID_VIDEO_SUBGROUP
7516b95f-f776-4464-8c53-06167f40cc99
 このサブグループの設定は、ビデオ電源管理機能の構成を制御します。
GUID_BATTERY_SUBGROUP
e73a048d-bf27-4f12-9731-8b2076e8891f
 このサブグループの設定は、バッテリアラームのトリップポイントとアクションを制御します。
GUID_SLEEP_SUBGROUP
238C9FA8-0AAD-41ED-83F4-97BE242C8F20
 このサブグループの設定は、システムのスリープ設定を制御します。
GUID_PCIEXPRESS_SETTINGS_SUBGROUP
501a4d13-42af-4429-9fd1-a8218c268e20
 このサブグループの設定は、PCI Express 設定を制御します。

[in] PowerSettingGuid

使用されている電源設定の識別子。

戻り値

指定した電源設定の現在の電源設定属性を返します。 属性は、電源設定の属性とそのサブグループの属性の組み合わせです。

リターン コード/値 Description
POWER_ATTRIBUTE_HIDE
1
 この電源設定を非表示にします。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー powrprof.h
Library PowrProf.lib
[DLL] PowrProf.dll

こちらもご覧ください

Power Management Functions