지정된 조건을 충족하는 시스템의 디바이스를 열거합니다.
구문
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 |
추가 정보
디바이스 전원 관리