struktur IDDCX_METADATA2 (iddcx.h)

IDDCX_METADATA2 menyediakan informasi tentang permukaan yang disediakan saat ini dan apa yang ditampilkan di atasnya.

Sintaks

struct IDDCX_METADATA2 {
  UINT                        Size;
  IDDCX_METADATA2_VALID_FLAGS ValidFlags;
  UINT                        PresentationFrameNumber;
  UINT                        DirtyRectCount;
  BOOL                        HwProtectedSurface;
  UINT64                      PresentDisplayQPCTime;
  IDXGIResource               *pSurface;
  DXGI_COLOR_SPACE_TYPE       SurfaceColorSpace;
  UINT                        SdrWhiteLevel;
  IDDCX_SYSTEM_BUFFER_INFO    SystemBufferInfo;
  IDDCX_HDR10_FRAME_METADATA  Hdr10FrameMetaData;
};

Anggota

Size

Ukuran total struktur, dalam byte.

ValidFlags

Bitwise-OR dari nilai IDDCX_METADATA2_VALID_FLAGS yang menunjukkan bidang mana dalam struktur ini yang memiliki konten yang valid.

PresentationFrameNumber

Nomor bingkai presentasi dari permukaan ini.

DirtyRectCount

Jumlah rect kotor untuk bingkai ini. Panggil IddCxSwapChainGetDirtyRects untuk mendapatkan rect kotor.

DirtyRectCount dari 1, di mana kotor tunggal memiliki semua nilai yang diatur ke nol, menunjukkan bahwa belum ada pembaruan gambar dari bingkai sebelumnya. Dalam situasi ini, driver memiliki kesempatan untuk mengodekan ulang gambar desktop lagi untuk meningkatkan kualitas visual. Setelah tidak ada lagi pembaruan, OS menyajikan bingkai yang sama sebanyak yang ditunjukkan oleh nilai IDDCX_ADAPTER_CAPS::StaticDesktopReencodeFrameCount , lalu berhenti menyajikan hingga pembaruan berikutnya.

HwProtectedSurface

Menunjukkan apakah permukaan yang disediakan dilindungi perangkat keras.

PresentDisplayQPCTime

Waktu QPC sistem ketika permukaan ini harus ditampilkan pada monitor tampilan tidak langsung.

pSurface

Penunjuk ke permukaan IDXGIResource DX yang berisi gambar untuk dikodekan dan ditransmisikan. Driver dapat menggunakan permukaan DX ini kapan saja sampai IddCxSwapChainReleaseAndAcquire dipanggil lagi.

SurfaceColorSpace

Nilai DXGI_COLOR_SPACE_TYPE yang menunjukkan ruang warna permukaan yang disediakan. Ruang warna biasanya cocok dengan yang ditentukan di jalur yang diterapkan.

SdrWhiteLevel

Tingkat putih dalam nits untuk konten SDR apa pun; misalnya, kursor mouse. Nilai ini selalu default ke 80 nit untuk mode non-HDR.

SystemBufferInfo

Struktur IDDCX_SYSTEM_BUFFER_INFO di mana informasi yang dihasilkan dari operasi rilis dan akuisisi dikembalikan.

Hdr10FrameMetaData

Struktur IDDCX_HDR10_FRAME_METADATA yang berisi metadata HDR10 untuk digunakan dengan bingkai ini.

Keterangan

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

Persyaratan

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

Lihat juga

IDARG_OUT_RELEASEANDACQUIREBUFFER2

IddCxSwapChainReleaseAndAcquireBuffer2