GetMonitorCapabilities-Funktion (highlevelmonitorconfigurationapi.h)
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 |