GetMonitorCapabilities 函式 (highlevelmonitorconfigurationapi.h)

警告

實體監視器組態函式的運作方式是使用 VESA 監視器控制命令集 (MCCS) I²C 介面的標準。許多監視器未完全實作該標準;因此，使用這些命令可能會導致未定義的監視行為。不建議將這些函式用於任意監視器，而不需實際驗證它們如預期般運作。

擷取監視器的組態功能。呼叫此函式，以找出監視器支援哪些高階監視器組態函式。

語法

_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 個 kelvins (K) 色彩溫度。
MC_SUPPORTED_COLOR_TEMPERATURE_5000K	監視器支援 5,000 K 色彩溫度。
MC_SUPPORTED_COLOR_TEMPERATURE_6500K	監視器支援 6,500 K 色彩溫度。
MC_SUPPORTED_COLOR_TEMPERATURE_7500K	監視器支援 7,500 K 色彩溫度。
MC_SUPPORTED_COLOR_TEMPERATURE_8200K	監視器支援 8,200 K 色彩溫度。
MC_SUPPORTED_COLOR_TEMPERATURE_9300K	監視器支援 9,300 K 色彩溫度。
MC_SUPPORTED_COLOR_TEMPERATURE_10000K	監視器支援 10,000 K 色彩溫度。
MC_SUPPORTED_COLOR_TEMPERATURE_11500K	監視器支援 11,500 K 色彩溫度。

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	highlevelmonitorconfigurationapi.h
程式庫	Dxva2.lib
Dll	Dxva2.dll