CapabilitiesRequestAndCapabilitiesReply-Funktion (lowlevelmonitorconfigurationapi.h)

Artikel
03/01/2024

Warnung

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

Ruft eine Zeichenfolge ab, die die Funktionen eines Monitors beschreibt.

Syntax

_BOOL CapabilitiesRequestAndCapabilitiesReply(
  [in]  HANDLE hMonitor,
  [out] LPSTR  pszASCIICapabilitiesString,
  [in]  DWORD  dwCapabilitiesStringLengthInCharacters
);

Parameter

[in] hMonitor

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

[out] pszASCIICapabilitiesString

Zeiger auf einen Puffer, der die Funktionszeichenfolge des Monitors empfängt. Der Aufrufer muss diesen Puffer zuordnen. Rufen Sie GetCapabilitiesStringLength auf, um die Größe der Zeichenfolge abzurufen. Die Funktionszeichenfolge ist immer eine ASCII-Zeichenfolge. Der Puffer muss Speicherplatz für das abschließende NULL-Zeichen enthalten.

[in] dwCapabilitiesStringLengthInCharacters

Größe von pszASCIICapabilitiesString in Zeichen, einschließlich des abschließenden 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 entspricht dem Befehl "Capabilities Request & Capabilities Reply" aus dem DDC/CI-Standard (Display Data Channel Command Interface). Weitere Informationen zur Funktionszeichenfolge finden Sie im DDC/CI-Standard.

Diese Funktion wird in der Regel schnell zurückgegeben, aber manchmal kann es einige Sekunden dauern, bis sie abgeschlossen ist.

Sie können die Funktionszeichenfolge eines Monitors aktualisieren, indem Sie der INF-Datei des Monitors eine AddReg-Direktive hinzufügen. Fügen Sie dem Treiberschlüssel des Monitors einen Registrierungsschlüssel namens "CapabilitiesString" hinzu. Der Wert des Registrierungsschlüssels ist die Funktionszeichenfolge. Der Registrierungsdatentyp ist REG_SZ.

HKR,,"CapabilitiesString",0x00000000,"updated capabilities string"

Warnung Ändern Sie die INF-Datei eines Monitors nur, wenn Sie mit dem Layout von INF-Dateien vertraut sind und auch den DDC/CI-Standard kennen.

Beispiele


DWORD cchStringLength = 0;
BOOL bSuccess = 0;
LPSTR szCapabilitiesString = NULL;

// Get the length of the string.
bSuccess = GetCapabilitiesStringLength(
   hPhysicalMonitor, // Handle to the monitor.
   &cchStringLength
   );

if (bSuccess)
{
    // Allocate the string buffer.
    LPSTR szCapabilitiesString = (LPSTR)malloc(cchStringLength);
    if (szCapabilitiesString != NULL)
    {
        // Get the capabilities string.
        bSuccess = CapabilitiesRequestAndCapabilitiesReply(
            hPhysicalMonitor,
            szCapabilitiesString,
            cchStringLength
            );

        // Free the string buffer.
        free(szCapabilitiesString);
    }
}

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

Share via