Share via

PowerWriteValueUnitsSpecifier 함수(powrprof.h)

  • 아티클

값 범위를 지원하는 전원 설정의 단위를 설명하는 데 사용되는 문자열을 씁니다. 예를 들어 시간 제한 설정을 설명하는 데 "분"을 사용할 수 있습니다.

구문

DWORD PowerWriteValueUnitsSpecifier(
  [in, optional] HKEY       RootPowerKey,
  [in, optional] const GUID *SubGroupOfPowerSettingsGuid,
  [in, optional] const GUID *PowerSettingGuid,
  [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] Buffer

와이드(유니코드) 문자의 단위 지정자입니다.

[in] BufferSize

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

반환 값

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

설명

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

요구 사항

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

추가 정보

전원 관리 함수