CapabilitiesRequestAndCapabilitiesReply-Funktion (lowlevelmonitorconfigurationapi.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 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"
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 |