GetCapabilitiesStringLength-Funktion (lowlevelmonitorconfigurationapi.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 die Länge der Funktionszeichenfolge eines Monitors ab.

Syntax

_BOOL GetCapabilitiesStringLength(
  [in]  HANDLE  hMonitor,
  [out] LPDWORD pdwCapabilitiesStringLengthInCharacters
);

Parameter

[in] hMonitor

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

[out] pdwCapabilitiesStringLengthInCharacters

Empfängt die Länge der Funktionszeichenfolge in Zeichen, einschließlich des beendenden NULL-Zeichens.

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 wird in der Regel schnell zurückgegeben, manchmal kann es jedoch einige Sekunden dauern, bis sie abgeschlossen ist.

Anforderungen

   
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

CapabilitiesRequestAndCapabilitiesReply

Überwachen von Konfigurationsfunktionen