DXGKDDI_SETTARGETADJUSTEDCOLORIMETRY fungsi panggilan balik (dispmprt.h)

Artikel
08/07/2023

Melaporkan nilai colorimetry yang dipilih oleh OS untuk target.

Sintaks

DXGKDDI_SETTARGETADJUSTEDCOLORIMETRY DxgkddiSettargetadjustedcolorimetry;

NTSTATUS DxgkddiSettargetadjustedcolorimetry(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN D3DDDI_VIDEO_PRESENT_TARGET_ID TargetId,
  [in] IN DXGK_COLORIMETRY AdjustedColorimetry
)
{...}

Parameter

[in] hAdapter

[in] Mengidentifikasi adaptor.

[in] TargetId

[in] Pengidentifikasi video adaptor tampilan menyajikan target.

[in] AdjustedColorimetry

[in] Struktur DXGK_COLORIMETRY yang berisi bidang terkait colorimetry untuk monitor yang melekat pada target ini setelah OS memproses pendeskripsi perangkat tampilan, semua penimpaan, dan penyesuaian apa pun.

Nilai kembali

Driver mengembalikan STATUS_SUCCESS jika memiliki pembaruan nilai colorimetry berdasarkan data yang disediakan.

Jika driver gagal, OS akan kembali ke nilai SDR standar untuk semua parameter, 709 utama, gamma 2,2 dan 8-nit per warna komponen format kawat RGB tetapi tidak akan memanggil driver karena ini seharusnya tidak pernah gagal. Sebagai gantinya, driver juga harus memperbarui representasi internal perangkat tampilan menjadi SDR standar.

Keterangan

Karena perangkat tampilan saat ini telah ditemukan memiliki deskripsi parameter terkait colorimetry yang tidak lengkap dan tidak akurat, penimpaan diperlukan. Penimpaan mengambil dua formulir: penimpaan driver dan penimpaan OS untuk parameter yang tidak valid. Dalam versi OS yang akan datang, diharapkan penimpaan tambahan akan diterapkan. Agar driver tetap sinkron dengan parameter yang digunakan OS, OS akan memanggil DxgkDdiSetTargetAdjustedColorimetry untuk setiap target.

Biasanya, panggilan ini hanya akan dilakukan sekali setelah driver dikueri untuk penimpaan dan validasi OS telah selesai tetapi sebelum tampilan diaktifkan. Ketika OS memiliki bentuk penimpaan lain, ada kemungkinan bahwa mereka akan tiba setelah tampilan sudah aktif. Dalam hal ini, OS masih akan memperbarui driver yang diharapkan untuk membuat pembaruan yang diperlukan untuk alur tampilannya dalam dua bingkai. Jika perlu, driver harus melatakan output tampilan untuk menerapkan perubahan.

FormatBitDepths dan StandardColorimetryFlags di DXGK_COLORIMETRY di-nol karena ini adalah bidang kemampuan sehingga hanya valid dalam kueri.

Fungsi ini selalu dipanggil pada tingkat PASIF sehingga kode pendukung harus dibuat dapat dipaginasi jika memungkinkan.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	dispmprt.h

Bagikan melalui