Freigeben über


DisplayConfigGetDeviceInfo-Funktion (winuser.h)

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)

Weitere Informationen

DISPLAYCONFIG_DEVICE_INFO_HEADER

DISPLAYCONFIG_TARGET_DEVICE_NAME

DISPLAYCONFIG_TARGET_DEVICE_NAME_FLAGS

DisplayConfigSetDeviceInfo