DisplayConfigSetDeviceInfo-Funktion (winuser.h)
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 |
|---|---|
|
Die Funktion wurde erfolgreich ausgeführt. |
|
Die angegebene Kombination von Parametern und Flags ist ungültig. |
|
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. |
|
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. |
|
Die Größe des Pakets, das der Aufrufer übergibt, ist nicht groß genug. |
|
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) |