Fungsi GetMonitorCapabilities (highlevelmonitorconfigurationapi.h)

Peringatan

Fungsi konfigurasi monitor fisik berfungsi menggunakan standar VESA Monitor Control Command Set (MCCS) melalui antarmuka I²C. Banyak monitor tidak sepenuhnya menerapkan standar tersebut; sehingga penggunaan perintah ini dapat mengakibatkan perilaku monitor yang tidak terdefinisi. Kami tidak merekomendasikan penggunaan fungsi-fungsi ini untuk monitor arbitrer tanpa memvalidasi secara fisik bahwa fungsi tersebut berfungsi seperti yang dimaksudkan.

Mengambil kemampuan konfigurasi monitor. Panggil fungsi ini untuk mengetahui fungsi konfigurasi monitor tingkat tinggi mana yang didukung oleh monitor.

Sintaksis

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

Parameter-parameternya

[in] hMonitor

Tangani ke monitor fisik. Untuk mendapatkan handel monitor, panggil GetPhysicalMonitorsFromHMONITOR atau GetPhysicalMonitorsFromIDirect3DDevice9.

[out] pdwMonitorCapabilities

Menerima bendera bitwise ATAU kemampuan. Lihat Komentar.

[out] pdwSupportedColorTemperatures

Menerima bitwise ATAU bendera suhu warna. Lihat Komentar.

Mengembalikan nilai

Jika fungsi berhasil, nilai pengembalian TRUE. Jika fungsi gagal, nilai yang dikembalikan adalah FALSE. Untuk mendapatkan informasi kesalahan yang diperluas, panggil GetLastError.

Fungsi gagal jika monitor tidak mendukung DDC/CI.

Komentar

Bendera kemampuan yang dikembalikan dalam pdwMonitorCapabilities menentukan fungsi konfigurasi monitor tingkat tinggi mana yang didukung oleh monitor. Mereka juga menentukan bagaimana fungsi tertentu berakibat. Bendera kemampuan berikut didefinisikan.

Nilai	Deskripsi
MC_CAPS_BRIGHTNESS	Monitor mendukung fungsi GetMonitorBrightness dan SetMonitorBrightness .
MC_CAPS_COLOR_TEMPERATURE	Monitor mendukung fungsi GetMonitorColorTemperature dan SetMonitorColorTemperature .
MC_CAPS_CONTRAST	Monitor mendukung fungsi GetMonitorContrast dan SetMonitorContrast .
MC_CAPS_DEGAUSS	Monitor mendukung fungsi DegaussMonitor .
MC_CAPS_DISPLAY_AREA_POSITION	Monitor mendukung fungsi GetMonitorDisplayAreaPosition dan SetMonitorDisplayAreaPosition .
MC_CAPS_DISPLAY_AREA_SIZE	Monitor mendukung fungsi GetMonitorDisplayAreaSize dan SetMonitorDisplayAreaSize .
MC_CAPS_MONITOR_TECHNOLOGY_TYPE	Monitor mendukung fungsi GetMonitorTechnologyType .
MC_CAPS_NONE	Monitor tidak mendukung pengaturan monitor apa pun.
MC_CAPS_RED_GREEN_BLUE_DRIVE	Monitor mendukung fungsi GetMonitorRedGreenOrBlueDrive dan SetMonitorRedGreenOrBlueDrive .
MC_CAPS_RED_GREEN_BLUE_GAIN	Monitor mendukung fungsi GetMonitorRedGreenOrBlueGain dan SetMonitorRedGreenOrBlueGain .
MC_CAPS_RESTORE_FACTORY_COLOR_DEFAULTS	Monitor mendukung fungsi RestoreMonitorFactoryColorDefaults .
MC_CAPS_RESTORE_FACTORY_DEFAULTS	Monitor mendukung fungsi RestoreMonitorFactoryDefaults .
MC_RESTORE_FACTORY_DEFAULTS_ENABLES_MONITOR_SETTINGS	Jika bendera ini ada, memanggil fungsi RestoreMonitorFactoryDefaults memungkinkan semua pengaturan monitor yang digunakan oleh fungsi konfigurasi monitor tingkat tinggi. Untuk informasi selengkapnya, lihat bagian Keterangan di RestoreMonitorFactoryDefaults.

 

Bendera suhu warna yang dikembalikan dalam pdwSupportedColorTemperatures menentukan suhu warna mana yang didukung oleh monitor. Bendera suhu warna berikut didefinisikan.

Nilai	Deskripsi
MC_SUPPORTED_COLOR_TEMPERATURE_NONE	Tidak ada suhu warna yang didukung.
MC_SUPPORTED_COLOR_TEMPERATURE_4000K	Monitor ini mendukung suhu warna 4.000 kelvins (K).
MC_SUPPORTED_COLOR_TEMPERATURE_5000K	Monitor mendukung suhu warna 5.000 K.
MC_SUPPORTED_COLOR_TEMPERATURE_6500K	Monitor mendukung suhu warna 6.500 K.
MC_SUPPORTED_COLOR_TEMPERATURE_7500K	Monitor mendukung suhu warna 7.500 K.
MC_SUPPORTED_COLOR_TEMPERATURE_8200K	Monitor mendukung suhu warna 8.200 K.
MC_SUPPORTED_COLOR_TEMPERATURE_9300K	Monitor mendukung suhu warna 9.300 K.
MC_SUPPORTED_COLOR_TEMPERATURE_10000K	Monitor mendukung suhu warna 10.000 K.
MC_SUPPORTED_COLOR_TEMPERATURE_11500K	Monitor mendukung suhu warna 11.500 K.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Platform Target	Windows
Header	highlevelmonitorconfigurationapi.h
Perpustakaan	Dxva2.lib
DLL	Dxva2.dll

Lihat juga

Fungsi Konfigurasi Monitor