EVT_IDD_CX_ADAPTER_COMMIT_MODES2 Rückruffunktion (iddcx.h)

Artikel
02/07/2025

Das Betriebssystem ruft EVT_IDD_CX_ADAPTER_COMMIT_MODES2 auf, um den Treiber über eine Modusänderung für Monitore auf dem Adapter zu informieren.

Syntax

EVT_IDD_CX_ADAPTER_COMMIT_MODES2 EvtIddCxAdapterCommitModes2;

NTSTATUS EvtIddCxAdapterCommitModes2(
  IDDCX_ADAPTER AdapterObject,
  const IDARG_IN_COMMITMODES2 *pInArgs
)
{...}

Parameter

AdapterObject

[in] Das vom Betriebssystem generierte Adapterobjekt des abgefragten Adapters. Dieses IDDCX_ADAPTER Objekthandle wurde in einem vorherigen Aufruf von IddCxAdapterInitAsynczurückgegeben.

pInArgs

[in] Zeiger auf eine IDARG_IN_COMMITMODES2 Struktur, die Argumente enthält, die von EVT_IDD_CX_ADAPTER_COMMIT_MODES2verwendet werden.

Rückgabewert

EVT_IDD_CX_ADAPTER_COMMIT_MODES2 gibt einen NTSTATUS- Wert zurück. Wenn der Vorgang erfolgreich ist, wird STATUS_SUCCESS oder ein anderer Statuswert zurückgegeben, für den NT_SUCCESS(Status) GLEICH WAHR ist. Andernfalls wird ein entsprechender NTSTATUS-Fehlercode zurückgegeben.

Bemerkungen

Wenn Modi für Monitore zugesichert werden, werden IddCx Version 1.10-Treiber, die HDR oder WCG unterstützen, über diese Funktion aufgerufen und angewiesen, den Farbraum und die Bits pro Komponente auf der physischen Monitorverbindung zu verwenden. Diese Werte basieren auf den Zielfunktionen und Modusparametern, die zuvor vom Treiber gemeldet wurden. Die Berichterstellung Adapterunterstützung für FP16-, aber keine Anzeige dieser Funktion ist ein Fehler.

Der in einem zugesicherten Modus angegebene Farbraum gibt nicht das Oberflächenformat an, das für jede Oberfläche in einer Swapchain verwendet wird. Die in IDDCX_METADATA2 bereitgestellte Oberfläche muss weiterhin abgefragt werden.

Das Betriebssystem stellt immer die IDDCX_PATH2 für jeden verbundenen Monitor bereit, auch wenn dieser Monitor nicht aktiv ist, und gibt an, welche Pfade geändert wurden. Wenn ein Pfad als inaktiv markiert ist, wird die gesamte Anzeigepipeline für diesen Pfad ausgeschaltet, und es wird kein Signal an den Monitor gesendet.

Wenn ein neuer Pfad zugesichert wird, sollte der Treiber die Anzeigepipeline so programmieren, dass ein schwarzes Bild angezeigt wird, bis der erste Frame angezeigt werden kann. Um dies zu erreichen, sollte die WDDM-Sichtbarkeit deaktiviert sein, bis der erste Frame angezeigt werden kann, dann sollte die Sichtbarkeit aktiviert sein.

Weitere Informationen zur HDR-Unterstützung finden Sie unter IddCx Version 1.10-Updates.