GetMonitorCapabilities-Funktion (highlevelmonitorconfigurationapi.h)

  • Artikel

Warnung

Die Konfigurationsfunktionen des physischen Monitors arbeiten mit dem VESA Monitor Control Command Set (MCCS)-Standard über eine I2C-Schnittstelle. Viele Monitore implementieren diesen Standard nicht vollständig. Daher kann die Verwendung dieser Befehle zu einem nicht definierten Überwachungsverhalten führen. Es wird nicht empfohlen, diese Funktionen für beliebige Monitore zu verwenden, ohne physisch zu überprüfen, dass sie wie beabsichtigt funktionieren.

Ruft die Konfigurationsfunktionen eines Monitors ab. Rufen Sie diese Funktion auf, um herauszufinden, welche allgemeinen Überwachungskonfigurationsfunktionen vom Monitor unterstützt werden.

Syntax

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

Parameter

[in] hMonitor

Handle für einen physischen Monitor. Rufen Sie zum Abrufen des Monitorhandles GetPhysicalMonitorsFromHMONITOR oder GetPhysicalMonitorsFromIDirect3DDevice9 auf.

[out] pdwMonitorCapabilities

Empfängt ein bitweises OR mit Funktionsflags. Siehe Hinweise.

[out] pdwSupportedColorTemperatures

Empfängt ein bitweises OR mit Farbtemperaturflags. Siehe Hinweise.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert TRUE. Wenn die Funktion fehlschlägt, ist der Rückgabewert FALSE. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Die Funktion schlägt fehl, wenn der Monitor DDC/CI nicht unterstützt.

Hinweise

Die in pdwMonitorCapabilities zurückgegebenen Funktionsflags geben an, welche allgemeinen Überwachungskonfigurationsfunktionen vom Monitor unterstützt werden. Sie geben auch an, wie sich bestimmte Funktionen verhalten. Die folgenden Funktionenflags sind definiert.

Wert BESCHREIBUNG
MC_CAPS_BRIGHTNESS Der Monitor unterstützt die Funktionen GetMonitorBrightness und SetMonitorBrightness .
MC_CAPS_COLOR_TEMPERATURE Der Monitor unterstützt die Funktionen GetMonitorColorTemperature und SetMonitorColorTemperature .
MC_CAPS_CONTRAST Der Monitor unterstützt die Funktionen GetMonitorContrast und SetMonitorContrast .
MC_CAPS_DEGAUSS Der Monitor unterstützt die DegaussMonitor-Funktion .
MC_CAPS_DISPLAY_AREA_POSITION Der Monitor unterstützt die Funktionen GetMonitorDisplayAreaPosition und SetMonitorDisplayAreaPosition .
MC_CAPS_DISPLAY_AREA_SIZE Der Monitor unterstützt die Funktionen GetMonitorDisplayAreaSize und SetMonitorDisplayAreaSize .
MC_CAPS_MONITOR_TECHNOLOGY_TYPE Der Monitor unterstützt die GetMonitorTechnologyType-Funktion .
MC_CAPS_NONE Der Monitor unterstützt keine Überwachungseinstellungen.
MC_CAPS_RED_GREEN_BLUE_DRIVE Der Monitor unterstützt die Funktionen GetMonitorRedGreenOrBlueDrive und SetMonitorRedGreenOrBlueDrive .
MC_CAPS_RED_GREEN_BLUE_GAIN Der Monitor unterstützt die Funktionen GetMonitorRedGreenOrBlueGain und SetMonitorRedGreenOrBlueGain .
MC_CAPS_RESTORE_FACTORY_COLOR_DEFAULTS Der Monitor unterstützt die RestoreMonitorFactoryColorDefaults-Funktion .
MC_CAPS_RESTORE_FACTORY_DEFAULTS Der Monitor unterstützt die RestoreMonitorFactoryDefaults-Funktion .
MC_RESTORE_FACTORY_DEFAULTS_ENABLES_MONITOR_SETTINGS Wenn dieses Flag vorhanden ist, werden durch Aufrufen der RestoreMonitorFactoryDefaults-Funktion alle Überwachungseinstellungen aktiviert, die von den allgemeinen Überwachungskonfigurationsfunktionen verwendet werden. Weitere Informationen finden Sie im Abschnitt "Hinweise" unter RestoreMonitorFactoryDefaults.
 

Die in pdwSupportedColorTemperatures zurückgegebenen Farbtemperaturflags geben an, welche Farbtemperaturen vom Monitor unterstützt werden. Die folgenden Farbtemperaturflags sind definiert.

Wert BESCHREIBUNG
MC_SUPPORTED_COLOR_TEMPERATURE_NONE Es werden keine Farbtemperaturen unterstützt.
MC_SUPPORTED_COLOR_TEMPERATURE_4000K Der Monitor unterstützt die Farbtemperatur von 4.000 Kelvin (K).
MC_SUPPORTED_COLOR_TEMPERATURE_5000K Der Monitor unterstützt 5.000 K Farbtemperatur.
MC_SUPPORTED_COLOR_TEMPERATURE_6500K Der Monitor unterstützt eine Farbtemperatur von 6.500 K.
MC_SUPPORTED_COLOR_TEMPERATURE_7500K Der Monitor unterstützt eine Farbtemperatur von 7.500 K.
MC_SUPPORTED_COLOR_TEMPERATURE_8200K Der Monitor unterstützt 8.200 K Farbtemperatur.
MC_SUPPORTED_COLOR_TEMPERATURE_9300K Der Monitor unterstützt 9.300 K Farbtemperatur.
MC_SUPPORTED_COLOR_TEMPERATURE_10000K Der Monitor unterstützt 10.000 K Farbtemperatur.
MC_SUPPORTED_COLOR_TEMPERATURE_11500K Der Monitor unterstützt 11.500 K Farbtemperatur.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile highlevelmonitorconfigurationapi.h
Bibliothek Dxva2.lib
DLL Dxva2.dll

Weitere Informationen

Überwachen von Konfigurationsfunktionen