Fungsi IddCxSwapChainReleaseAndAcquireBuffer2 (iddcx.h)

Artikel
11/11/2023

Driver tampilan tidak langsung memanggil IddCxSwapChainReleaseAndAcquireBuffer2 untuk merilis buffer saat ini dalam rantai pertukaran dan memperoleh yang baru. Driver yang mendukung adaptor HDR harus menggunakan IddCxSwapChainReleaseAndAcquireBuffer2 alih-alih IddCxSwapChainReleaseAndAcquireBuffer dan IddCxSwapChainReleaseAndAcquireSystemBuffer.

Sintaks

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

Parameter

SwapChainObject

[in] Objek swap-chain sebelumnya diteruskan oleh OS ke driver dalam panggilan EVT_IDD_CX_MONITOR_ASSIGN_SWAPCHAIN .

pInArgs

[in] Penunjuk ke struktur IDARG_IN_RELEASEANDACQUIREBUFFER2 yang berisi argumen input untuk fungsi tersebut.

pOutArgs

[keluar] Penunjuk ke struktur IDARG_OUT_RELEASEANDACQUIREBUFFER2 tempat argumen output fungsi dikembalikan.

Nilai kembali

IddCxSwapChainReleaseAndAcquireBuffer2 mengembalikan S_OK pada keberhasilan; jika tidak, ia mengembalikan kode kesalahan yang sesuai.

Keterangan

Ruang warna permukaan yang diteruskan di struct IDDCX_METADATA2 juga diteruskan ke driver. Ini karena dapat berubah berdasarkan per bingkai dan tidak cocok dengan ruang warna yang ditentukan ketika mode diterapkan.

Demikian pula, format piksel dari permukaan yang disediakan dapat berubah berdasarkan bingkai demi bingkai. Misalnya, jika mode HDR diterapkan pada jalur, ini tidak menjamin bahwa setiap permukaan akan menjadi permukaan FP16.

Tingkat putih untuk konten SDR juga disertakan untuk diterapkan ke kursor mouse.

Jika IDDCX_METADATA2_VALID_FLAGS_HDR10METADATA diatur dalam IDDCX_METADATA2::ValidFlags , IDDCX_METADATA2::Hdr10FrameMetaData berisi data yang valid. Metadata ini bisa menjadi salah satu dari tiga jenis:

Data baru yang harus digunakan driver.
Indikasi bahwa metadata default yang sebelumnya dikirim ke driver dalam panggilan ke EVT_IDD_CX_MONITOR_SET_DEFAULT_HDR_METADATA harus digunakan.
Indikasi bahwa metadata apa pun yang sebelumnya dikirim harus digunakan lagi. Ketika jenis default atau tidak berubah, maka nilai dalam IDDCX_HDR10_FRAME_METADATA::NewMetaData tidak valid.

IddCxSwapChainReleaseAndAcquireBuffer2 juga menggantikan IddCxSwapChainReleaseAndAcquireSystemBuffer. Driver yang akan disebut IddCxSwapChainReleaseAndAcquireSystemBuffer dapat mengatur IDARG_IN_RELEASEANDACQUIREBUFFER2::AcquireSystemMemoryBuffer untuk menunjukkan bahwa perlu IDDCX_METADATA2::SystemBufferInfo yang diisi.

Driver versi 1.10 yang tidak melaporkan dukungan FP16 masih dapat memanggil fungsi ini jika tersedia di OS.

Untuk informasi selengkapnya tentang dukungan HDR, lihat Pembaruan IddCx versi 1.10.

Metadata HDR jarak jauh

OS tidak akan meneruskan metadata HDR ke driver jarak jauh karena metadata HDR pada sistem klien harus digunakan, bukan yang dihasilkan oleh server. Untuk driver jarak jauh IDDCX_METADATA2_VALID_FLAGS_HDR10METADATA tidak akan pernah diatur.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 11, Pembaruan September versi 22H2 (IddCx versi 1.10)
Header	iddcx.h

Lihat juga

IDARG_IN_RELEASEANDACQUIREBUFFER2

IDARG_OUT_RELEASEANDACQUIREBUFFER2

IDDCX_METADATA2

Share via