PowerReadDCValue 関数 (powersetting.h)

指定した電源設定の DC 電源値を取得します。

構文

DWORD PowerReadDCValue(
  [in, optional]  HKEY       RootPowerKey,
  [in, optional]  const GUID *SchemeGuid,
  [in, optional]  const GUID *SubGroupOfPowerSettingsGuid,
  [in, optional]  const GUID *PowerSettingGuid,
  [out, optional] PULONG     Type,
  [out, optional] PUCHAR     Buffer,
  [in, out]       LPDWORD    BufferSize
);

パラメーター

[in, optional] RootPowerKey

このパラメーターは将来使用するために予約されており、 NULL に設定する必要があります。

[in, optional] SchemeGuid

電源スキームの識別子。

[in, optional] SubGroupOfPowerSettingsGuid

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

意味
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, optional] PowerSettingGuid

電源設定の識別子。

[out, optional] Type

値のデータ型を受け取る変数へのポインター。 使用可能な値は、「 レジストリ値の種類」に一覧表示されます。 このパラメーターは NULL にすることができ、データの型は返されません。

[out, optional] Buffer

データ値を受け取る変数へのポインター。 このパラメーターが NULL の場合、 BufferSize パラメーターは必要なバッファー サイズを受け取ります。

[in, out] BufferSize

Buffer パラメーターが指すバッファーのサイズを含む変数へのポインター。

Buffer パラメーターが NULL の場合、関数は ERROR_SUCCESSを返し、変数は必要なバッファー サイズを受け取ります。

指定されたバッファー サイズが要求されたデータを保持するのに十分な大きさでない場合、関数は ERROR_MORE_DATA を返し、変数は必要なバッファー サイズを受け取ります。

戻り値

び出しが成功した 場合はERROR_SUCCESS (ゼロ) を返し、呼び出しが失敗した場合は 0 以外の値を返します。 BufferSize パラメーターで指定されたバッファー サイズが小さすぎる場合は、ERROR_MORE_DATAが返され、BufferSize パラメーターによって指される DWORD が必要なバッファー サイズで入力されます。

要件

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

こちらもご覧ください

Power Management Functions