共用方式為


GetMonitorCapabilities 函式 (highlevelmonitorconfigurationapi.h)

警告

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

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

語法

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

參數

[in] hMonitor

實體監視器的句柄。 若要取得監視句柄,請呼叫 GetPhysicalMonitorsFromHMONITORGetPhysicalMonitorsFromIDirect3DDevice9

[out] pdwMonitorCapabilities

接收功能旗標的位 OR 。 請參閱<備註>。

[out] pdwSupportedColorTemperatures

接收色彩溫度旗標的位 OR 。 請參閱<備註>。

傳回值

如果函式成功,則傳回值為 TRUE。 如果函式失敗,則傳回值為 FALSE。 若要取得擴充的錯誤資訊,請呼叫 GetLastError

如果監視器不支援 DDC/CI,函式就會失敗。

備註

pdwMonitorCapabilities 中傳回的功能旗標會指定監視器支援哪些高階監視器組態函式。 它們也會指定特定函式的行為。 定義下列功能旗標。

Description
MC_CAPS_BRIGHTNESS 監視器支援 GetMonitorBrightnessSetMonitorBrightness 函式
MC_CAPS_COLOR_TEMPERATURE 監視器支援 GetMonitorColorTemperatureSetMonitorColorTemperature 函式。
MC_CAPS_CONTRAST 監視器支援 GetMonitorContrastSetMonitorContrast 函式。
MC_CAPS_DEGAUSS 監視器支援 DegaussMonitor 函式。
MC_CAPS_DISPLAY_AREA_POSITION 監視器支援 GetMonitorDisplayAreaPositionSetMonitorDisplayAreaPosition 函式。
MC_CAPS_DISPLAY_AREA_SIZE 監視器支援 GetMonitorDisplayAreaSizeSetMonitorDisplayAreaSize 函式。
MC_CAPS_MONITOR_TECHNOLOGY_TYPE 監視器支援 GetMonitorTechnologyType 函式。
MC_CAPS_NONE 監視器不支援任何監視設定。
MC_CAPS_RED_GREEN_BLUE_DRIVE 監視器支援 GetMonitorRedGreenOrBlueDriveSetMonitorRedGreenOrBlueDrive 函式。
MC_CAPS_RED_GREEN_BLUE_GAIN 監視器支援 GetMonitorRedGreenOrBlueGainSetMonitorRedGreenOrBlueGain 函式。
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

另請參閱

監視組態函式