GetPhysicalMonitors 함수
중요
이 함수는 모니터 구성 API에서 디스플레이 드라이버의 기능에 액세스하는 데 사용됩니다. 애플리케이션에서 이 함수를 호출하면 안 됩니다.
디스플레이 디바이스와 연결된 물리적 모니터를 가져옵니다.
구문
NTSTATUS WINAPI GetPhysicalMonitors(
_In_ UNICODE_STRING *pstrDeviceName,
_In_ DWORD dwPhysicalMonitorArraySize,
_Out_ DWORD *pdwNumPhysicalMonitorHandlesInArray,
_Out_ HANDLE *phPhysicalMonitorArray
);
매개 변수
-
pstrDeviceName [in]
-
GetMonitorInfo 함수에서 반환한 표시 디바이스의 이름을 포함하는 UNICODE_STRING 구조체에 대한 포인터입니다.
-
dwPhysicalMonitorArraySize [in]
-
pdwNumPhysicalMonitorHandlesInArray 배열의 요소 수입니다. 배열의 필요한 크기를 얻으려면 GetNumberOfPhysicalMonitors를 호출합니다.
-
pdwNumPhysicalMonitorHandlesInArray [out]
-
함수가 phPhysicalMonitorArray 배열에 복사하는 항목 수를 받습니다.
-
phPhysicalMonitorArray [out]
-
실제 모니터에 대한 핸들을 수신하는 배열입니다. 각 핸들은 DestroyPhysicalMonitor를 호출하여 해제해야 합니다.
반환 값
메서드가 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 NTSTATUS 오류 코드가 반환됩니다.
설명
애플리케이션은 이 함수를 사용하는 대신 다음 함수 중 하나를 호출해야 합니다.
이 함수에는 연결된 가져오기 라이브러리가 없습니다. 이 함수를 호출하려면 LoadLibrary 및 GetProcAddress 함수를 사용하여 Gdi32.dll 동적으로 연결해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
Windows Server 2008 [데스크톱 앱만 해당] |
| DLL |
|