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 |