IddCxSwapChainReleaseAndAcquireBuffer2-Funktion (iddcx.h)

Artikel
02/07/2025

Ein indirekter Anzeigetreiber ruft IddCxSwapChainReleaseAndAcquireBuffer2 auf, um den aktuellen Puffer in der Swapchain freizugeben und einen neuen zu erwerben. Ein Treiber, der HDR-Adapter unterstützt, muss IddCxSwapChainReleaseAndAcquireBuffer2- anstelle von IddCxSwapChainReleaseAndAcquireBuffer und IddCxSwapChainReleaseAndAcquireSystemBufferverwenden.

Syntax

HRESULT IddCxSwapChainReleaseAndAcquireBuffer2(
  IDDCX_SWAPCHAIN                    SwapChainObject,
  IDARG_IN_RELEASEANDACQUIREBUFFER2  *pInArgs,
  IDARG_OUT_RELEASEANDACQUIREBUFFER2 *pOutArgs
);

Parameter

SwapChainObject

[in] Das Swapchainobjekt, das zuvor vom Betriebssystem an den Treiber übergeben wurde, in einem EVT_IDD_CX_MONITOR_ASSIGN_SWAPCHAIN Aufruf.

pInArgs

[in] Zeigen Sie auf eine IDARG_IN_RELEASEANDACQUIREBUFFER2 Struktur, die die Eingabeargumente für die Funktion enthält.

pOutArgs

[out] Zeiger auf eine IDARG_OUT_RELEASEANDACQUIREBUFFER2 Struktur, in der die Ausgabeargumente der Funktion zurückgegeben werden.

Rückgabewert

IddCxSwapChainReleaseAndAcquireBuffer2 S_OK zurück; andernfalls wird ein entsprechender Fehlercode zurückgegeben.

Bemerkungen

Der Farbraum der Oberfläche, die in der IDDCX_METADATA2 Struktur übergeben wird, wird auch an den Treiber übergeben. Dies liegt daran, dass sie sich pro Frame ändern kann und nicht mit dem Farbraum übereinstimmt, der angegeben wurde, wenn ein Modus zugesichert wurde.

Entsprechend kann sich das Pixelformat der bereitgestellten Oberfläche auf Frame-nach-Frame-Basis ändern. Wenn beispielsweise ein HDR-Modus auf einem Pfad zugesichert wird, garantiert dies nicht, dass jede Oberfläche eine FP16-Oberfläche ist.

Die weiße Ebene für SDR-Inhalte ist ebenfalls enthalten, um auf Mauscursor anzuwenden.

Wenn IDDCX_METADATA2_VALID_FLAGS_HDR10METADATA in IDDCX_METADATA2::ValidFlags festgelegt ist, enthält IDDCX_METADATA2::Hdr10FrameMetaData gültige Daten. Diese Metadaten können einen von drei Typen sein:

Neue Daten, die der Treiber verwenden soll.
Ein Hinweis darauf, dass die zuvor an den Treiber gesendeten Standardmetadaten in einem Aufruf von EVT_IDD_CX_MONITOR_SET_DEFAULT_HDR_METADATA verwendet werden sollten.
Ein Hinweis darauf, dass alle zuvor gesendeten Metadaten erneut verwendet werden sollten. Wenn der Typ standardmäßig oder unverändert ist, sind die Werte in IDDCX_HDR10_FRAME_METADATA::NewMetaData ungültig.

IddCxSwapChainReleaseAndAcquireBuffer2 ersetzt auch IddCxSwapChainReleaseAndAcquireSystemBuffer. Ein Treiber, der IddCxSwapChainReleaseAndAcquireSystemBuffer- aufgerufen hätte, kann IDARG_IN_RELEASEANDACQUIREBUFFER2::AcquireSystemMemoryBuffer festlegen, um anzugeben, dass IDDCX_METADATA2::SystemBufferInfo ausgefüllt werden muss.

Version 1.10-Treiber, die FP16-Unterstützung nicht melden, können diese Funktion weiterhin aufrufen, wenn sie im Betriebssystem verfügbar ist.

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

Remote-HDR-Metadaten

Das Betriebssystem übergibt KEINE HDR-Metadaten an Remotetreiber, da die HDR-Metadaten auf dem Clientsystem verwendet werden sollten, nicht von dem Server generiert. Bei Remotetreibern wird IDDCX_METADATA2_VALID_FLAGS_HDR10METADATA nie festgelegt.