SetMonitorColorTemperature 함수(highlevelmonitorconfigurationapi.h)

경고

물리적 모니터 구성 함수는 I²C 인터페이스를 통해 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

참고 항목

구성 함수 모니터링