IddCxAdapterDisplayConfigUpdate-Funktion (iddcx.h)
Ein Remotetreiber kann IddCxAdapterDisplayConfigUpdate- aufrufen, damit ein Client dem Server mitteilen kann, wie die Monitorkonfiguration aktualisiert wird. Ein Treiber, der hdr-Unterstützung meldet, muss stattdessen IddCxAdapterDisplayConfigUpdate2- verwenden.
Syntax
NTSTATUS IddCxAdapterDisplayConfigUpdate(
IDDCX_ADAPTER AdapterObject,
const IDARG_IN_ADAPTERDISPLAYCONFIGUPDATE *pInArgs
);
Parameter
AdapterObject
[in] Das IDDCX_ADAPTER Objekt des Remoteadapters, für den die Anzeigekonfiguration angegeben ist.
pInArgs
[in] Zeigen Sie auf eine IDARG_IN_ADAPTERDISPLAYCONFIGUPDATE Struktur, die Eingabeargumente auf die Funktion enthält.
Rückgabewert
IddCxAdapterDisplayConfigUpdate gibt nach Erfolg STATUS_SUCCESS zurück; andernfalls wird ein entsprechender Fehlercode zurückgegeben. Siehe Anmerkungen.
Bemerkungen
Ein remote indirekter Anzeigetreiber (IDD) ruft IddCxAdapterDisplayConfigUpdate auf, wenn er eine neue Anzeigekonfiguration empfängt.
Das Betriebssystem gibt STATUS_SUCCESS zurück, wenn es die neu angegebene Anzeigekonfiguration gespeichert hat. Diese Änderungen konfigurieren die Swapchains für die Monitore asynchron wie angefordert neu. IddCxAdapterDisplayConfigUpdate löscht zunächst alle ausstehenden Monitorankünfte und verarbeitet Abfahrten, um sicherzustellen, dass die Liste der Monitore aktuell ist.
Wenn IddCxAdapterDisplayConfigUpdate bestimmt, dass die angegebene Anzeigekonfiguration derzeit vom Treiber nicht unterstützt wird, wird STATUS_INVALID_PARAMETER zurückgegeben und der Grund für die Verwendung von WPP für Debuggingzwecke protokolliert. Ein Treiber unterstützt z. B. möglicherweise keine angegebene Auflösungs-/Aktualisierungsrate, oder ein ungültiger Monitor wird angegeben.
IddCxAdapterDisplayConfigUpdate gibt STATUS_GRAPHICS_INDIRECT_DISPLAY_DEVICE_STOPPED zurück, wenn diese Konfigurationsänderung darauf ausgerichtet ist, die Verbindung zu trennen, oder wenn der Sitzungsadapter beendet wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 10, Version 1903 |
| Header- | iddcx.h |