GetMonitorCapabilities 函式 (highlevelmonitorconfigurationapi.h)

  • 發行項

警告

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

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

語法

_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中傳回的功能旗標會指定監視器支援哪些高階監視器組態函式。 它們也會指定特定函式的行為。 定義下列功能旗標。

值 描述
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中傳回的色彩溫度旗標會指定監視器支援哪些色彩溫度。 定義下列色彩溫度旗標。

值 描述
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

另請參閱

監視組態函式