EnumDisplayDevicesA 함수(winuser.h)
EnumDisplayDevices 함수를 사용하면 현재 세션의 디스플레이 디바이스에 대한 정보를 가져올 수 있습니다.
통사론
BOOL EnumDisplayDevicesA(
[in] LPCSTR lpDevice,
[in] DWORD iDevNum,
[out] PDISPLAY_DEVICEA lpDisplayDevice,
[in] DWORD dwFlags
);
매개 변수
[in] lpDevice
디바이스 이름에 대한 포인터입니다. NULL
자세한 내용은 비고를 참조하세요.
[in] iDevNum
관심 있는 표시 디바이스를 지정하는 인덱스 값입니다.
운영 체제는 인덱스 값을 사용하여 현재 세션의 각 디스플레이 디바이스를 식별합니다. 인덱스 값은 0부터 시작하는 연속 정수입니다. 예를 들어 현재 세션에 세 개의 디스플레이 디바이스가 있는 경우 인덱스 값 0, 1 및 2로 지정됩니다.
[out] lpDisplayDevice
iDevNum지정된 표시 디바이스에 대한 정보를 수신하는 DISPLAY_DEVICE 구조체에 대한 포인터입니다.
EnumDisplayDevices호출하기 전에 DISPLAY_DEVICEcb 멤버를 DISPLAY_DEVICE크기(바이트)로 초기화해야 합니다.
[in] dwFlags
이 플래그를 EDD_GET_DEVICE_INTERFACE_NAME(0x00000001)로 설정하여 모니터별로 운영 체제에서 등록하는 GUID_DEVINTERFACE_MONITOR 디바이스 인터페이스 이름을 검색합니다. 값은 lpDisplayDevice반환된 DISPLAY_DEVICE 구조체의 DeviceID 멤버에 배치됩니다. 결과 디바이스 인터페이스 이름은
반환 값
함수가 성공하면 반환 값은 0이 아닌 값입니다.
함수가 실패하면 반환 값은 0입니다. iDevNum 가장 큰 디바이스 인덱스보다 크면 함수가 실패합니다.
발언
현재 세션의 모든 표시 디바이스를 쿼리하려면 iDevNum 0으로 설정하고 함수가 실패할 때까지 iDevNum 증가시키는 루프에서 이 함수를 호출합니다. 데스크톱의 모든 디스플레이 디바이스를 선택하려면 DISPLAY_DEVICE 구조에 DISPLAY_DEVICE_ATTACHED_TO_DESKTOP 플래그가 있는 디스플레이 디바이스만 사용합니다.
디스플레이 어댑터에 대한 정보를 얻으려면 lpDeviceNULL설정된 EnumDisplayDevices 호출합니다. 예를 들어 DISPLAY_DEVICE.DeviceString 어댑터 이름을 포함합니다.
디스플레이 모니터에 대한 정보를 얻으려면 먼저
어댑터와 연결된 모든 모니터 디바이스를 쿼리하려면
메모
winuser.h 헤더는 ENumDisplayDevices를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows 2000 Server [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | winuser.h(Windows.h 포함) |
| 라이브러리 | User32.lib |
| DLL | User32.dll |
| API 집합 | ext-ms-win-ntuser-sysparams-ext-l1-1-1(Windows 10 버전 10.0.14393에 도입됨) |
참고 항목
changeDisplaySettings
CreateDC
DEVMODE