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 |