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