GetVCPFeatureAndVCPFeatureReply-Funktion (lowlevelmonitorconfigurationapi.h)

Artikel
02/28/2024

Warnung

Die Konfigurationsfunktionen des physischen Monitors funktionieren mit dem VESA Monitor Control Command Set (MCCS)-Standard über eine I²C-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 aktuellen Wert, den Maximalwert und den Codetyp eines VCP-Codes (Virtual Systemsteuerung) für einen Monitor ab.

Syntax

_BOOL GetVCPFeatureAndVCPFeatureReply(
  [in]  HANDLE             hMonitor,
  [in]  BYTE               bVCPCode,
  [out] LPMC_VCP_CODE_TYPE pvct,
  [out] LPDWORD            pdwCurrentValue,
  [out] LPDWORD            pdwMaximumValue
);

Parameter

[in] hMonitor

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

[in] bVCPCode

Abzufragenden VCP-Code. Die VCP-Codes sind include the VESA Monitor Control Command Set (MCCS)-Standard( Version 1.0 und 2.0). Dieser Parameter muss einen fortlaufenden oder nicht kontinuierlichen VCP oder einen herstellerspezifischen Code angeben. Es sollte kein Tabellensteuerelementcode sein.

[out] pvct

Empfängt den VCP-Codetyp als Member der MC_VCP_CODE_TYPE-Enumeration . Dieser Parameter kann NULL sein.

[out] pdwCurrentValue

Empfängt den aktuellen Wert des VCP-Codes. Dieser Parameter kann NULL sein.

[out] pdwMaximumValue

Wenn bVCPCode einen fortlaufenden VCP-Code angibt, empfängt dieser Parameter den Maximalwert des VCP-Codes. Wenn bVCPCode einen nicht fortlaufenden VCP-Code angibt, ist der in diesem Parameter empfangene Wert nicht definiert. Dieser Parameter kann NULL sein.

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

Diese Funktion entspricht dem Befehl "Get VCP Feature & VCP Feature Reply" aus dem DDC/CI-Standard (Display Data Channel Command Interface). Mit dieser Funktion können anbieterspezifische VCP-Codes verwendet werden.

Die Rückgabe dieser Funktion dauert etwa 40 Millisekunden.

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	lowlevelmonitorconfigurationapi.h
Bibliothek	Dxva2.lib
DLL	Dxva2.dll

Weitere Informationen

Überwachen von Konfigurationsfunktionen

Freigeben über