DisplayConfigGetDeviceInfo-Funktion (winuser.h)

Artikel
03/04/2024

Die DisplayConfigGetDeviceInfo-Funktion ruft Anzeigekonfigurationsinformationen zum Gerät ab.

Syntax

LONG DisplayConfigGetDeviceInfo(
  [in, out] DISPLAYCONFIG_DEVICE_INFO_HEADER *requestPacket
);

Parameter

[in, out] requestPacket

Ein Zeiger auf eine DISPLAYCONFIG_DEVICE_INFO_HEADER-Struktur . Diese Struktur enthält Informationen zur Anforderung, die den Pakettyp im Typmember enthält. Der Typ und die Größe zusätzlicher Daten, die DisplayConfigGetDeviceInfo nach der Headerstruktur zurückgibt, hängen vom Pakettyp ab.

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 aus Parametern und Flags ist ungültig.
ERROR_NOT_SUPPORTED	Auf dem System wird kein Grafiktreiber ausgeführt, 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_INSUFFICIENT_BUFFER	Die Größe des Pakets, das der Aufrufer übergibt, ist nicht groß genug für die Vom Aufrufer angeforderten Informationen.
ERROR_GEN_FAILURE	Es ist ein unbekannter Fehler aufgetreten.

Hinweise

Verwenden Sie die DisplayConfigGetDeviceInfo-Funktion , um zusätzliche Informationen zu einer Quelle oder einem Ziel für einen Adapter zu erhalten, z. B. den Anzeigenamen, den bevorzugten Anzeigemodus und den Namen des Quellgeräts.

Der Aufrufer kann DisplayConfigGetDeviceInfo aufrufen, um weitere Anzeigenamen zu erhalten, die auf der Benutzeroberfläche angezeigt werden. Der Aufrufer kann Namen für den Adapter, die Quelle und das Ziel abrufen. Der Aufrufer kann auch DisplayConfigGetDeviceInfo aufrufen, um die beste Auflösung des verbundenen Anzeigegeräts zu erhalten.

Beispiele

Ein Beispiel für DisplayConfigGetDeviceInfo finden Sie unter QueryDisplayConfig.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Zielplattform	Universell
Header	winuser.h (windows.h einschließen)
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)