Share via

DisplayConfigSetDeviceInfo-Funktion (winuser.h)

  • Artikel

Die DisplayConfigSetDeviceInfo-Funktion legt die Eigenschaften eines Ziels fest.

Syntax

LONG DisplayConfigSetDeviceInfo(
  [in] DISPLAYCONFIG_DEVICE_INFO_HEADER *setPacket
);

Parameter

[in] setPacket

Ein Zeiger auf eine DISPLAYCONFIG_DEVICE_INFO_HEADER Struktur, die Informationen enthält, die für das Gerät festgelegt werden sollen. Der Typ und die Größe zusätzlicher Daten, die DisplayConfigSetDeviceInfo für die Konfiguration verwendet, kommen nach der Headerstruktur. Diese zusätzlichen Daten hängen vom Pakettyp ab, wie durch den Typmember von DISPLAYCONFIG_DEVICE_INFO_HEADER angegeben. Wenn der Aufrufer beispielsweise die Startpersistenz ändern möchte, weist dieser Aufrufer eine DISPLAYCONFIG_SET_TARGET_PERSISTENCE-Struktur zu und füllt sie aus und übergibt einen Zeiger auf diese Struktur in setPacket. Beachten Sie, dass das erste Element der DISPLAYCONFIG_SET_TARGET_PERSISTENCE-Struktur das DISPLAYCONFIG_DEVICE_INFO_HEADER ist.

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_INSUFFICIENT_BUFFER
 Die Größe des Pakets, das der Aufrufer übergibt, ist nicht groß genug.
ERROR_GEN_FAILURE
 Es ist ein unbekannter Fehler aufgetreten.

Hinweise

DisplayConfigSetDeviceInfo kann derzeit nur zum Starten und Beenden der persistierten Startprojektion für ein analoges Ziel verwendet werden. Weitere Informationen zur Startpersistenz finden Sie unter Erzwungene und verbundene Ziele.

DisplayConfigSetDeviceInfo kann nur verwendet werden, um DISPLAYCONFIG_DEVICE_INFO_SET_XXX Typ von Informationen festzulegen. DisplayConfigSetDeviceInfo schlägt fehl, wenn der Typmember von DISPLAYCONFIG_DEVICE_INFO_HEADER auf einen der DISPLAYCONFIG_DEVICE_INFO_GET_XXX-Werte festgelegt ist.

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

DISPLAYCONFIG_DEVICE_INFO_HEADER

DisplayConfigGetDeviceInfo