Share via

DevicePowerEnumDevices 함수(powrprof.h)

  • 아티클

지정된 조건을 충족하는 시스템의 디바이스를 열거합니다.

구문

BOOLEAN DevicePowerEnumDevices(
  [in]            ULONG  QueryIndex,
  [in]            ULONG  QueryInterpretationFlags,
  [in]            ULONG  QueryFlags,
  [out, optional] PBYTE  pReturnBuffer,
  [in, out]       PULONG pBufferSize
);

매개 변수

[in] QueryIndex

요청된 디바이스의 인덱스입니다. 초기 호출의 경우 이 값은 0이어야 합니다.

[in] QueryInterpretationFlags

검색 결과에 적용되는 조건입니다.

값 의미
DEVICEPOWER_HARDWAREID
0x80000000
 친숙한 디바이스 이름이 아닌 하드웨어 ID 문자열을 반환합니다.
DEVICEPOWER_FILTER_DEVICES_PRESENT
0x20000000
 현재 시스템에 없는 디바이스는 무시합니다.
DEVICEPOWER_AND_OPERATION
0x40000000
 QueryFlags에서 AND 작업을 수행합니다.
DEVICEPOWER_FILTER_WAKEENABLED
0x08000000
디바이스가 현재 절전 모드 상태에서 시스템을 절전 모드 해제하도록 설정되어 있는지 확인합니다.
DEVICEPOWER_FILTER_ON_NAME
0x02000000
 이름이 pReturnBuffer에 전달된 문자열과 일치하는 디바이스를 찾고 QueryFlags에 대한 기능을 검사.

[in] QueryFlags

쿼리 조건입니다.

값 의미
PDCAP_D0_SUPPORTED
0x00000001
 디바이스는 시스템 전원 상태 D0을 지원합니다.
PDCAP_D1_SUPPORTED
0x00000002
 디바이스는 시스템 전원 상태 D1을 지원합니다.
PDCAP_D2_SUPPORTED
0x00000004
 디바이스는 시스템 전원 상태 D2를 지원합니다.
PDCAP_D3_SUPPORTED
0x00000008
 디바이스는 시스템 전원 상태 D3를 지원합니다.
PDCAP_S0_SUPPORTED
0x00010000
 디바이스는 시스템 절전 상태 S0을 지원합니다.
PDCAP_S1_SUPPORTED
0x00020000
 디바이스는 시스템 절전 상태 S1을 지원합니다.
PDCAP_S2_SUPPORTED
0x00040000
 디바이스는 시스템 절전 상태 S2를 지원합니다.
PDCAP_S3_SUPPORTED
0x00080000
 디바이스는 시스템 절전 상태 S3을 지원합니다.
PDCAP_S4_SUPPORTED
0x01000000
 디바이스는 시스템 절전 상태 S4를 지원합니다.
PDCAP_S5_SUPPORTED
0x02000000
 디바이스는 시스템 절전 상태 S5를 지원합니다.
PDCAP_WAKE_FROM_D0_SUPPORTED
0x00000010
 디바이스는 시스템 전원 상태 D0에서 절전 모드 해제를 지원합니다.
PDCAP_WAKE_FROM_D1_SUPPORTED
0x00000020
 디바이스는 시스템 전원 상태 D1에서 절전 모드 해제를 지원합니다.
PDCAP_WAKE_FROM_D2_SUPPORTED
0x00000040
 디바이스는 시스템 전원 상태 D2에서 절전 모드 해제를 지원합니다.
PDCAP_WAKE_FROM_D3_SUPPORTED
0x00000080
 디바이스는 시스템 전원 상태 D3에서 절전 모드 해제를 지원합니다.
PDCAP_WAKE_FROM_S0_SUPPORTED
0x00100000
 디바이스는 시스템 절전 상태 S0에서 절전 모드 해제를 지원합니다.
PDCAP_WAKE_FROM_S1_SUPPORTED
0x00200000
 디바이스는 시스템 절전 상태 S1에서 절전 모드 해제를 지원합니다.
PDCAP_WAKE_FROM_S2_SUPPORTED
0x00400000
디바이스는 시스템 절전 상태 S2에서 절전 모드 해제를 지원합니다.
PDCAP_WAKE_FROM_S3_SUPPORTED
0x00800000
디바이스는 시스템 절전 상태 S3에서 절전 모드 해제를 지원합니다.
PDCAP_WARM_EJECT_SUPPORTED
0x00000100
 디바이스는 웜 배출을 지원합니다.

[out, optional] pReturnBuffer

요청된 정보를 수신하는 버퍼에 대한 포인터입니다.

[in, out] pBufferSize

반환 버퍼의 크기(바이트)입니다.

참고pReturnBuffer 가 NULL인 경우 pBufferSize 는 데이터를 반환하는 데 필요한 크기로 채워집니다.
 

반환 값

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다.

설명

QueryFlags 매개 변수의 값을 결합하여 둘 이상의 조건을 지원하는 디바이스를 쿼리할 수 있습니다. 예를 들어; PDCAP_D3_SUPPORTED | PDCAP_D1_SUPPORTEDQueryFlags 매개 변수로 전달되면 함수는 D3 또는 D1을 지원하는 디바이스를 쿼리합니다.

또한 QueryFlags는 요청된 모든 조건을 지원하는 디바이스의 쿼리를 생성하기 위해 DEVICEPOWER_AND_OPERATION 설정된 QueryInterpretationFlags와 결합될 수 있습니다. 예를 들어; PDCAP_D3_SUPPORTED | PDCAP_D1_SUPPORTEDQueryFlags 매개 변수로 전달되고 DEVICEPOWER_AND_OPERATIONQueryInterpretationFlags 매개 변수로 전달되면 함수는 D3 및 D1을 모두 지원하는 디바이스를 쿼리합니다.

예제

이 함수를 사용하는 예제는 디바이스 전원 API 사용을 참조하세요.

요구 사항

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

추가 정보

디바이스 전원 관리