EnumDisplayMonitors 함수(winuser.h)

아티클
08/27/2023

EnumDisplayMonitors 함수는 지정된 클리핑 사각형의 교집합 및 디바이스 컨텍스트의 표시 영역에 의해 형성된 영역을 교차하는 디스플레이 모니터(미러링 드라이버와 연결된 보이지 않는 의사 모니터 포함)를 열거합니다. EnumDisplayMonitors 는 열거된 각 모니터에 대해 애플리케이션 정의 MonitorEnumProc 콜백 함수를 한 번 호출합니다. GetSystemMetrics(SM_CMONITORS)는 디스플레이 모니터만 계산합니다.

구문

BOOL EnumDisplayMonitors(
  [in] HDC             hdc,
  [in] LPCRECT         lprcClip,
  [in] MONITORENUMPROC lpfnEnum,
  [in] LPARAM          dwData
);

매개 변수

[in] hdc

관심 있는 표시 영역을 정의하는 디스플레이 디바이스 컨텍스트에 대한 핸들입니다.

이 매개 변수가 NULL이면 콜백 함수에 전달된 hdcMonitor 매개 변수가 NULL이고, 관심 있는 영역은 바탕 화면의 모든 디스플레이를 포함하는 가상 화면입니다.

[in] lprcClip

클리핑 사각형을 지정하는 RECT 구조체에 대한 포인터입니다. 관심 영역은 hdc로 지정된 가시 영역과 클리핑 사각형의 교차점입니다.

hdc가 NULL이 아닌 경우 클리핑 사각형의 좌표는 hdc의 원점과 상대적입니다. hdc가 NULL인 경우 좌표는 가상 화면 좌표입니다.

hdc로 지정된 영역을 잘라내지 않으려면 이 매개 변수는 NULL일 수 있습니다.

[in] lpfnEnum

MonitorEnumProc 애플리케이션 정의 콜백 함수에 대한 포인터입니다.

[in] dwData

EnumDisplayMonitors가 MonitorEnumProc 함수에 직접 전달하는 애플리케이션 정의 데이터입니다.

반환 값

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

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

설명

EnumDisplayMonitors 함수를 호출하는 데는 두 가지 이유가 있습니다.

여러 디스플레이 모니터에 걸쳐 있고 모니터의 색 형식이 다른 디바이스 컨텍스트에 최적으로 그리려고 합니다.
하나 이상의 디스플레이 모니터에 대한 핸들 및 위치 사각형을 가져오려고 합니다.

시스템의 모든 디스플레이 모니터가 동일한 색 형식을 공유하는지 확인하려면 GetSystemMetrics (SM_SAMEDISPLAYFORMAT)를 호출합니다.

창 범위가 다른 색 형식의 모니터를 표시하는 경우 EnumDisplayMonitors 함수를 사용할 필요가 없습니다. 전체 화면에 기본 모니터의 색 속성이 있다는 가정 하에 계속 그릴 수 있습니다. 창이 잘 보입니다. EnumDisplayMonitors 를 사용하면 더 잘 보이게 할 수 있습니다.

hdc 매개 변수를 NULL로 설정하면 EnumDisplayMonitors 함수를 사용하여 하나 이상의 디스플레이 모니터에 대한 핸들 및 위치 사각형을 가져올 수 있습니다. 다음 표에서는 NULL 및 비 NULLhdc 및 lprcClip 값의 네 가지 조합이 EnumDisplayMonitors 함수의 동작에 미치는 영향을 보여 줍니다.

Hdc	lprcRect	EnumDisplayMonitors 동작
NULL	NULL	모든 디스플레이 모니터를 열거합니다. 콜백 함수는 NULL HDC를 수신합니다.
NULL	NULL이 아닌 경우	클리핑 사각형과 교차하는 모든 디스플레이 모니터를 열거합니다. 클리핑 사각형에 가상 화면 좌표를 사용합니다. 콜백 함수는 NULL HDC를 수신합니다.
NULL이 아닌 경우	NULL	디바이스 컨텍스트의 표시되는 영역과 교차하는 모든 디스플레이 모니터를 열거합니다. 콜백 함수는 특정 디스플레이 모니터에 대한 DC에 대한 핸들을 받습니다.
NULL이 아닌 경우	NULL이 아닌 경우	디바이스 컨텍스트의 표시되는 영역과 클리핑 사각형을 교차하는 모든 디스플레이 모니터를 열거합니다. 클리핑 사각형에 디바이스 컨텍스트 좌표를 사용합니다. 콜백 함수는 특정 디스플레이 모니터에 대한 DC에 대한 핸들을 받습니다.

예제

각 모니터의 기능을 사용하여 WM_PAINT 메시지에 대한 응답으로 그리려면 창 프로시저에서 다음과 같은 코드를 사용할 수 있습니다.


case WM_PAINT:
  hdc = BeginPaint(hwnd, &ps);
  EnumDisplayMonitors(hdc, NULL, MyPaintEnumProc, 0);
  EndPaint(hwnd, &ps);

각 모니터의 기능을 사용하여 창의 위쪽 절반을 그리려면 다음과 같은 코드를 사용할 수 있습니다.


GetClientRect(hwnd, &rc);
rc.bottom = (rc.bottom - rc.top) / 2;
hdc = GetDC(hwnd);
EnumDisplayMonitors(hdc, &rc, MyPaintEnumProc, 0);
ReleaseDC(hwnd, hdc);

각 디스플레이 모니터에 대해 전체 가상 화면을 최적으로 그리려면 다음과 같은 코드를 사용할 수 있습니다.


hdc = GetDC(NULL);
EnumDisplayMonitors(hdc, NULL, MyPaintScreenEnumProc, 0);
ReleaseDC(NULL, hdc);

모든 디스플레이 모니터에 대한 정보를 검색하려면 다음과 같은 코드를 사용합니다.


EnumDisplayMonitors(NULL, NULL, MyInfoEnumProc, 0);

요구 사항

요구 사항	값
지원되는 최소 클라이언트	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에 도입됨)