다음을 통해 공유

GetMonitorCapabilities 함수(highlevelmonitorconfigurationapi.h)

  • 아티클

경고

물리적 모니터 구성 함수는 I2C 인터페이스를 통해 MCCS(VESA Monitor Control Command Set) 표준을 사용하여 작동합니다. 대부분의 모니터는 해당 표준을 완전히 구현하지 않습니다. 따라서 이러한 명령을 사용하면 정의되지 않은 모니터 동작이 발생할 수 있습니다. 의도한 대로 작동하는지 물리적으로 확인하지 않고 임의 모니터에 이러한 함수를 사용하지 않는 것이 좋습니다.

모니터의 구성 기능을 검색합니다. 이 함수를 호출하여 모니터에서 지원하는 상위 수준 모니터 구성 함수를 확인합니다.

구문

_BOOL GetMonitorCapabilities(
  [in]  HANDLE  hMonitor,
  [out] LPDWORD pdwMonitorCapabilities,
  [out] LPDWORD pdwSupportedColorTemperatures
);

매개 변수

[in] hMonitor

실제 모니터에 대한 핸들입니다. 모니터 핸들을 얻으려면 GetPhysicalMonitorsFromHMONITOR 또는 GetPhysicalMonitorsFromIDirect3DDevice9를 호출합니다.

[out] pdwMonitorCapabilities

기능 플래그의 비트 OR 을 받습니다. 설명 부분을 참조하세요.

[out] pdwSupportedColorTemperatures

색 온도 플래그의 비트 OR 을 받습니다. 설명 부분을 참조하세요.

반환 값

함수가 성공하면 반환 값은 TRUE입니다. 함수가 실패하면 반환 값은 FALSE입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

모니터가 DDC/CI를 지원하지 않으면 함수가 실패합니다.

설명

pdwMonitorCapabilities에서 반환되는 기능 플래그는 모니터에서 지원하는 상위 수준 모니터 구성 함수를 지정합니다. 또한 특정 함수의 동작 방식을 지정합니다. 다음 기능 플래그가 정의됩니다.

값 Description
MC_CAPS_BRIGHTNESS 모니터는 GetMonitorBrightness 및 SetMonitorBrightness 함수를 지원합니다.
MC_CAPS_COLOR_TEMPERATURE 모니터는 GetMonitorColorTemperature 및 SetMonitorColorTemperature 함수를 지원합니다.
MC_CAPS_CONTRAST 모니터는 GetMonitorContrast 및 SetMonitorContrast 함수를 지원합니다.
MC_CAPS_DEGAUSS 모니터는 DegaussMonitor 함수를 지원합니다 .
MC_CAPS_DISPLAY_AREA_POSITION 모니터는 GetMonitorDisplayAreaPosition 및 SetMonitorDisplayAreaPosition 함수를 지원합니다.
MC_CAPS_DISPLAY_AREA_SIZE 모니터는 GetMonitorDisplayAreaSize 및 SetMonitorDisplayAreaSize 함수를 지원합니다.
MC_CAPS_MONITOR_TECHNOLOGY_TYPE 모니터는 GetMonitorTechnologyType 함수를 지원합니다.
MC_CAPS_NONE 모니터는 모니터 설정을 지원하지 않습니다.
MC_CAPS_RED_GREEN_BLUE_DRIVE 모니터는 GetMonitorRedGreenOrBlueDrive 및 SetMonitorRedGreenOrBlueDrive 함수를 지원합니다.
MC_CAPS_RED_GREEN_BLUE_GAIN 모니터는 GetMonitorRedGreenOrBlueGain 및 SetMonitorRedGreenOrBlueGain 함수를 지원합니다.
MC_CAPS_RESTORE_FACTORY_COLOR_DEFAULTS 모니터는 RestoreMonitorFactoryColorDefaults 함수를 지원합니다 .
MC_CAPS_RESTORE_FACTORY_DEFAULTS 모니터는 RestoreMonitorFactoryDefaults 함수를 지원합니다 .
MC_RESTORE_FACTORY_DEFAULTS_ENABLES_MONITOR_SETTINGS 이 플래그가 있는 경우 RestoreMonitorFactoryDefaults 함수를 호출하면 상위 수준 모니터 구성 함수에서 사용하는 모든 모니터 설정을 사용할 수 있습니다. 자세한 내용은 RestoreMonitorFactoryDefaults의 설명 섹션을 참조하세요.
 

pdwSupportedColorTemperatures에서 반환된 색 온도 플래그는 모니터에서 지원하는 색 온도를 지정합니다. 다음 색 온도 플래그가 정의됩니다.

값 Description
MC_SUPPORTED_COLOR_TEMPERATURE_NONE 색 온도는 지원되지 않습니다.
MC_SUPPORTED_COLOR_TEMPERATURE_4000K 모니터는 4,000 켈빈(K) 색 온도를 지원합니다.
MC_SUPPORTED_COLOR_TEMPERATURE_5000K 모니터는 5,000K 색 온도를 지원합니다.
MC_SUPPORTED_COLOR_TEMPERATURE_6500K 모니터는 6,500K 색 온도를 지원합니다.
MC_SUPPORTED_COLOR_TEMPERATURE_7500K 모니터는 7,500K 색 온도를 지원합니다.
MC_SUPPORTED_COLOR_TEMPERATURE_8200K 모니터는 8,200K 색 온도를 지원합니다.
MC_SUPPORTED_COLOR_TEMPERATURE_9300K 모니터는 9,300K 색 온도를 지원합니다.
MC_SUPPORTED_COLOR_TEMPERATURE_10000K 모니터는 10,000K 색 온도를 지원합니다.
MC_SUPPORTED_COLOR_TEMPERATURE_11500K 모니터는 11,500K 색 온도를 지원합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 highlevelmonitorconfigurationapi.h
라이브러리 Dxva2.lib
DLL Dxva2.dll

추가 정보

구성 함수 모니터링