DXGKDDI_PRESENTDISPLAYONLY fungsi panggilan balik (d3dkmddi.h)

Artikel
02/23/2024

Menyajikan gambar layar ke perangkat tampilan driver khusus tampilan mode kernel (KMDOD).

Sintaks

DXGKDDI_PRESENTDISPLAYONLY DxgkddiPresentdisplayonly;

NTSTATUS DxgkddiPresentdisplayonly(
  IN_CONST_HANDLE hAdapter,
  IN_CONST_PDXGKARG_PRESENT_DISPLAYONLY pPresentDisplayOnly
)
{...}

Parameter

hAdapter

Handel ke konteks perangkat untuk adaptor tampilan. Fungsi DxgkDdiAddDevice KMDOD sebelumnya mengembalikan handel ini dalam parameter MiniportDeviceContext .

pPresentDisplayOnly

Penunjuk ke struktur DXGKARG_PRESENT_DISPLAYONLY yang berisi informasi tentang operasi saat ini.

Menampilkan nilai

Mengembalikan salah satu nilai berikut:

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Operasi saat ini berhasil diselesaikan.
STATUS_PENDING	Operasi saat ini telah dikirim ke antrean perangkat lunak atau perangkat keras untuk diselesaikan. Dalam hal ini, KMDOD harus menggunakan panggilan prosedur interupsi dan ditangguhkan (DPC) untuk melaporkan kemajuan operasi saat ini. Jika tidak, sistem operasi menggunakan proses Deteksi dan Pemulihan Waktu Habis (TDR), yang melaporkan kesalahan dan mengharuskan KMDOD untuk menginisialisasi ulang dirinya sendiri dan mengatur ulang GPU. Perhatikan bahwa kode status ini tidak boleh dikembalikan untuk mode sinkron, seperti yang dijelaskan dalam Keterangan.

Menampilkan kode

Deskripsi

STATUS_SUCCESS

Operasi saat ini berhasil diselesaikan.

STATUS_PENDING

Operasi saat ini telah dikirim ke antrean perangkat lunak atau perangkat keras untuk diselesaikan.
Dalam hal ini, KMDOD harus menggunakan panggilan prosedur interupsi dan ditangguhkan (DPC) untuk melaporkan kemajuan operasi saat ini. Jika tidak, sistem operasi menggunakan proses Deteksi dan Pemulihan Waktu Habis (TDR), yang melaporkan kesalahan dan mengharuskan KMDOD untuk menginisialisasi ulang dirinya sendiri dan mengatur ulang GPU.
Perhatikan bahwa kode status ini tidak boleh dikembalikan untuk mode sinkron, seperti yang dijelaskan dalam Keterangan.

Driver juga dapat mengembalikan kode status kesalahan lain yang ditentukan dalam Ntstatus.h untuk menunjukkan masalah yang telah terjadi dengan operasi saat ini.

Keterangan

KMDOD harus menyelesaikan semua gerakan layar ke layar sebelum menyalin persegi panjang kotor. Selain itu, KMDOD harus menyelesaikan setiap operasi pemindahan/salin sebelum memulai operasi pemindahan/penyalinan lain.

Sistem operasi mendukung dua mode KMDOD yang menyajikan operasi: sinkron dan asinkron. Bergantung pada implementasi perangkat keras dan driver, KMDOD dapat menggunakan mode atau beralih di antaranya kapan saja.

Sistem operasi menjamin bahwa fungsi ini mengikuti mode sinkronisasi tingkat nol seperti yang didefinisikan dalam Threading dan Synchronization Zero Level.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8
Server minimum yang didukung	Windows Server 2012
Target Platform	Desktop
Header	d3dkmddi.h
IRQL	PASSIVE_LEVEL