GetMonitorRedGreenOrBlueDrive-Funktion (highlevelmonitorconfigurationapi.h)

  • Artikel

Warnung

Die Konfigurationsfunktionen des physischen Monitors funktionieren 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 vorgesehen funktionieren.

Ruft den Wert des roten, grünen oder blauen Laufwerks eines Monitors ab.

Syntax

_BOOL GetMonitorRedGreenOrBlueDrive(
  [in]  HANDLE        hMonitor,
  [in]  MC_DRIVE_TYPE dtDriveType,
  [out] LPDWORD       pdwMinimumDrive,
  [out] LPDWORD       pdwCurrentDrive,
  [out] LPDWORD       pdwMaximumDrive
);

Parameter

[in] hMonitor

Handle mit einem physischen Monitor. Um das Monitorhandle abzurufen, rufen Sie GetPhysicalMonitorsFromHMONITOR oder GetPhysicalMonitorsFromIDirect3DDevice9 auf.

[in] dtDriveType

Ein Member der MC_DRIVE_TYPE-Enumeration , die angibt, ob der Wert des roten, grünen oder blauen Laufwerks abgerufen werden soll.

[out] pdwMinimumDrive

Empfängt den minimalen Wert des roten, grünen oder blauen Laufwerks.

[out] pdwCurrentDrive

Empfängt den aktuellen Wert des roten, grünen oder blauen Laufwerks.

[out] pdwMaximumDrive

Empfängt den maximalen Wert des roten, grünen oder blauen Laufwerks.

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.

Hinweise

Laufwerkeinstellungen werden in der Regel verwendet, um den Weißpunkt des Monitors anzupassen. Laufwerk und Schwarzstufe sind unterschiedliche Namen für dieselbe Monitoreinstellung. Wenn diese Funktion unterstützt wird, gibt die GetMonitorCapabilities-Funktion das MC_CAPS_RED_GREEN_BLUE_DRIVE-Flag zurück.

Die Rückgabe dieser Funktion dauert etwa 40 Millisekunden.

Bei den Laufwerkeinstellungen handelt es sich um fortlaufende Überwachungseinstellungen. Weitere Informationen finden Sie unter Verwenden der High-Level Monitorkonfigurationsfunktionen.

Anforderungen

   
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