PowerWritePossibleValue 함수(powrprof.h)

전원 설정의 가능한 값에 대한 값을 설정합니다.

구문

DWORD PowerWritePossibleValue(
  [in, optional] HKEY       RootPowerKey,
  [in, optional] const GUID *SubGroupOfPowerSettingsGuid,
  [in, optional] const GUID *PowerSettingGuid,
  [in]           ULONG      Type,
  [in]           ULONG      PossibleSettingIndex,
  [in]           UCHAR      *Buffer,
  [in]           DWORD      BufferSize
);

매개 변수

[in, optional] RootPowerKey

이 매개 변수는 나중에 사용하도록 예약되어 있으며 NULL로 설정해야 합니다.

[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

전원 설정의 식별자입니다.

[in] Type

값에 대한 데이터 형식입니다. 가능한 값은 레지스트리 값 형식에 나열됩니다.

[in] PossibleSettingIndex

가능한 설정에 대한 인덱스(0부터 시작)입니다.

[in] Buffer

가능한 설정의 값입니다.

[in] BufferSize

Buffer 매개 변수가 가리키는 버퍼 의 크기입니다.

반환 값

호출이 성공하면 ERROR_SUCCESS (0)을 반환하고 호출이 실패한 경우 0이 아닌 값을 반환합니다.

설명

활성 전원 구성표에 대한 설정 변경 내용은 PowerSetActiveScheme 함수를 호출할 때까지 적용되지 않습니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 powrprof.h
라이브러리 PowrProf.lib
DLL PowrProf.dll

추가 정보

전원 관리 함수