DXGKDDI_POSTMULTIPLANEOVERLAYPRESENT fungsi panggilan balik (d3dkmddi.h)

  • Artikel

Dipanggil setelah konfigurasi overlay multi-bidang baru berlaku, memungkinkan driver untuk mengoptimalkan status perangkat keras. Opsional untuk driver Windows Display Driver Model (WDDM) 2.0 atau yang lebih baru yang mendukung overlay multi-bidang.

Sintaks

DXGKDDI_POSTMULTIPLANEOVERLAYPRESENT DxgkddiPostmultiplaneoverlaypresent;

NTSTATUS DxgkddiPostmultiplaneoverlaypresent(
  IN_CONST_HANDLE hAdapter,
  IN_CONST_PDXGKARG_POSTMULTIPLANEOVERLAYPRESENT pPostPresent
)
{...}

Parameter

hAdapter

Mengidentifikasi adaptor yang berisi perangkat keras overlay.

pPostPresent

Penunjuk ke struktur DXGKARG_POSTMULTIPLANEOVERLAYPRESENT yang menjelaskan konfigurasi overlay baru yang baru diterapkan baru-baru ini.

Mengembalikan nilai

DXGKDDI_POSTMULTIPLANEOVERLAYPRESENT mengembalikan nilai berikut:

Menampilkan kode Deskripsi
STATUS_SUCCESS Jika rutinitas telah berhasil diselesaikan. Driver harus selalu mengembalikan kode keberhasilan. Kegagalan akan mengakibatkan pemeriksaan bug.

Keterangan

Fungsi ini dipanggil dari tingkat PASSIVE.

Fungsi ini hanya dipanggil ketika driver menetapkan PostPresentNeeded dari anggota DXGKCB_NOTIFY_MPO_VSYNC_FLAGS struktur DXGKARGCB_NOTIFY_INTERRUPT_DATA dalam panggilan balik VSYNC.

Driver dapat menggunakan fungsi ini untuk menurunkan tingkat tegangan, jam, kedalaman FIFO, atau pengoptimalan lainnya yang dapat menghemat daya.

Driver tidak boleh menghabiskan banyak waktu dalam panggilan ini karena panggilan memblokir utas penjadwal GPU utama dan penundaan dapat menyebabkan gangguan. Tindakan intensif waktu harus diantrekan sebagai item kerja terpisah oleh driver dan ditangani di latar belakang. Dalam skenario ini, setiap konflik antara item yang diantrekan dan perubahan perangkat keras yang diminta oleh panggilan pra/pasca di masa mendatang harus dikelola oleh driver.

Persyaratan

Persyaratan Nilai
Target Platform Windows
Header d3dkmddi.h