SetMonitorColorTemperature 함수(highlevelmonitorconfigurationapi.h)
경고
물리적 모니터 구성 함수는 I2C 인터페이스를 통해 MCCS(VESA Monitor Control Command Set) 표준을 사용하여 작동합니다. 대부분의 모니터는 해당 표준을 완전히 구현하지 않습니다. 따라서 이러한 명령을 사용하면 정의되지 않은 모니터 동작이 발생할 수 있습니다. 의도한 대로 작동하는지 물리적으로 확인하지 않고 임의 모니터에 이러한 함수를 사용하지 않는 것이 좋습니다.
모니터의 색 온도를 설정합니다.
구문
_BOOL SetMonitorColorTemperature(
[in] HANDLE hMonitor,
[in] MC_COLOR_TEMPERATURE ctCurrentColorTemperature
);
매개 변수
[in] hMonitor
실제 모니터에 대한 핸들입니다. 모니터 핸들을 얻으려면 GetPhysicalMonitorsFromHMONITOR 또는 GetPhysicalMonitorsFromIDirect3DDevice9를 호출합니다.
[in] ctCurrentColorTemperature
MC_COLOR_TEMPERATURE 열거 형의 멤버로 지정된 색 온도입니다.
반환 값
함수가 성공하면 반환 값은 TRUE입니다. 함수가 실패하면 반환 값은 FALSE입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.
설명
이 함수가 지원되는 경우 GetMonitorCapabilities 함수는 MC_CAPS_COLOR_TEMPERATURE 플래그를 반환합니다. GetMonitorCapabilities 함수는 모니터에서 지원하는 색 온도 범위도 반환합니다. ctCurrentColorTemperature 매개 변수는 이러한 값 중 하나에 해당해야 합니다.
색 온도를 변경하면 모니터의 흰색 점이 변경되었습니다. 또한 현재 드라이브를 변경하고 설정을 얻을 수 있습니다. 새 드라이브를 가져오고 설정을 가져오려면 GetMonitorRedGreenOrBlueDrive 및 GetMonitorRedGreenOrBlueGain을 각각 호출합니다.
이 함수는 반환하는 데 50~90밀리초가 걸립니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | highlevelmonitorconfigurationapi.h |
| 라이브러리 | Dxva2.lib |
| DLL | Dxva2.dll |