GetDisplayConfigBufferSizes-Funktion (winuser.h)

Artikel
03/13/2024

Die GetDisplayConfigBufferSizes-Funktion ruft die Größe der Puffer ab, die zum Aufrufen der QueryDisplayConfig-Funktion erforderlich sind.

Syntax

LONG GetDisplayConfigBufferSizes(
  [in]  UINT32 flags,
  [out] UINT32 *numPathArrayElements,
  [out] UINT32 *numModeInfoArrayElements
);

Parameter

[in] flags

Der Typ der abzurufenden Informationen. Der Wert für den Flags-Parameter muss einer der folgenden Werte sein.

QDC_ALL_PATHS

Der Aufrufer fordert die Tabellengrößen auf, um alle möglichen Pfadkombinationen zu enthalten.

QDC_ONLY_ACTIVE_PATHS

Der Aufrufer fordert die Tabellengrößen auf, nur aktive Pfade zu enthalten.

QDC_DATABASE_CURRENT

Der Aufrufer fordert die Tabellengrößen an, um die aktiven Pfade wie in der Persistenzdatenbank für die aktuell verbundenen Monitore zu speichern.

[out] numPathArrayElements

Zeiger auf eine Variable, die die Anzahl der Elemente in der Pfadinformationstabelle empfängt. Der pNumPathArrayElements-Parameterwert wird dann von einem nachfolgenden Aufruf der QueryDisplayConfig-Funktion verwendet. Dieser Parameter darf nicht NULL sein.

[out] numModeInfoArrayElements

Zeiger auf eine Variable, die die Anzahl der Elemente in der Modusinformationstabelle empfängt. Der pNumModeInfoArrayElements-Parameterwert wird dann von einem nachfolgenden Aufruf der QueryDisplayConfig-Funktion verwendet. Dieser Parameter darf nicht NULL sein.

Rückgabewert

Die Funktion gibt einen der folgenden Rückgabecodes zurück.

Rückgabecode	Beschreibung
ERROR_SUCCESS	Die Funktion wurde erfolgreich ausgeführt.
ERROR_INVALID_PARAMETER	Die angegebene Kombination von Parametern und Flags ist ungültig.
ERROR_NOT_SUPPORTED	Das System führt keinen Grafiktreiber aus, der gemäß dem Windows Display Driver Model (WDDM) geschrieben wurde. Die Funktion wird nur auf einem System unterstützt, auf dem ein WDDM-Treiber ausgeführt wird.
ERROR_ACCESS_DENIED	Der Aufrufer hat keinen Zugriff auf die Konsolensitzung. Dieser Fehler tritt auf, wenn der aufrufende Prozess keinen Zugriff auf den aktuellen Desktop hat oder in einer Remotesitzung ausgeführt wird.
ERROR_GEN_FAILURE	Es ist ein unbekannter Fehler aufgetreten.

Hinweise

Angesichts der aktuellen Anzeigepfadkonfiguration und der angeforderten Flags gibt GetDisplayConfigBufferSizes die Größe der Pfad- und Modustabellen zurück, die zum Speichern der Informationen erforderlich sind. GetDisplayConfigBufferSizes kann Werte zurückgeben, die etwas größer als tatsächlich erforderlich sind, da dadurch bestimmt wird, dass alle Quell- und Zielpfade gültig sind. der Fahrer kann jedoch einige Einschränkungen für die möglichen Kombinationen festlegen.

Da GetDisplayConfigBufferSizes nur die erforderliche Arraygröße dieses Zeitpunkts bestimmen kann, ist es möglich, dass zwischen Aufrufen von GetDisplayConfigBufferSizes und QueryDisplayConfig die Systemkonfiguration geändert wurde und die bereitgestellten Arraygrößen nicht mehr ausreichen, um die neuen Pfaddaten zu speichern.

Wenn ein Aufrufer weiß, dass er zusätzliche Quellen und Ziele aktivieren muss, kann der Aufrufer ein größeres Modusinformationsarray zuordnen, als von GetDisplayConfigBufferSizes zurückgegeben wird, sodass er über den Speicherplatz zum Hinzufügen der zusätzlichen Quell- und Zielmodi nach dem Aufrufen von QueryDisplayConfig und vor dem Aufruf von SetDisplayConfig verfügt.

Beispiele

Ein Beispiel für GetDisplayConfigBufferSizes finden Sie unter QueryDisplayDisplayConfigConfig.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Zielplattform	Universell
Header	winuser.h (einschließlich Windows.h)
Bibliothek	User32.lib; OneCoreUAP.lib auf Windows 10
DLL	User32.dll
APIs	ext-ms-win-ntuser-sysparams-ext-l1-1-1 (eingeführt in Windows 10, Version 10.0.14393)

Weitere Informationen

QueryDisplayConfig

SetDisplayConfig

Share via