EVT_IDD_CX_ADAPTER_COMMIT_MODES2 Rückruffunktion (iddcx.h)

Artikel
02/29/2024

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 IddCxAdapterInitAsync zurückgegeben.

pInArgs

[in] Zeiger auf eine IDARG_IN_COMMITMODES2-Struktur , die von EVT_IDD_CX_ADAPTER_COMMIT_MODES2 verwendete Argumente enthält.

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 status Wert zurückgegeben, für den NT_SUCCESS(status) true entspricht. Andernfalls wird ein entsprechender NTSTATUS-Fehlercode zurückgegeben.

Hinweise

Wenn Modi für Monitore festgelegt werden, werden IddCx-Treiber der Version 1.10, die HDR oder WCG unterstützen, über diese Funktion aufgerufen und der Farbraum und die Bits pro Komponente angegeben, die für die Physische Monitorverbindung verwendet werden sollen. Diese Werte basieren auf den Zielfunktionen und Modusparametern, die zuvor vom Treiber gemeldet wurden. Das Melden von Adapterunterstützung für FP16 , aber das Nicht-Verfügbarmachen dieser Funktion ist ein Fehler.

Der in einem Commitmodus 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 sich geändert haben. 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 committet 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, und dann sollte die Sichtbarkeit aktiviert sein.

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