Bagikan melalui


DXGKDDI_QUERYDIRTYBITDATA fungsi panggilan balik (d3dkmddi.h)

Dxgkrnl memanggil DxgkDdiQueryDirtyBitData untuk meminta salinan data bitplane kotor dari driver miniport tampilan mode kernel (KMD).

Sintaks

DXGKDDI_QUERYDIRTYBITDATA DxgkddiQuerydirtybitdata;

NTSTATUS DxgkddiQuerydirtybitdata(
  IN_CONST_HANDLE hAdapter,
  INOUT_PDXGKARG_QUERYDIRTYBITDATA pArgs
)
{...}

Parameter

hAdapter

[in] Handel ke blok konteks yang terkait dengan adaptor tampilan. KMD sebelumnya menyediakan handel ini ke Dxgkrnl dalam parameter output MiniportDeviceContext dari fungsi DxgiDdiAddDevice .

pArgs

[masuk/keluar] Penunjuk ke struktur DXGKARG_QUERYDIRTYBITDATA yang berisi informasi input dan output untuk kueri.

Menampilkan nilai

DxgkDdiQueryDirtyBitData mengembalikan STATUS_SUCCESS jika kueri berhasil. Jika tidak, kode kesalahan NTSTATUS akan ditampilkan.

Keterangan

Fungsi ini menyediakan basis memori dan pengidentifikasi subrange potensial untuk informasi kotor yang diminta. KMD harus menulis data yang dihasilkan ke buffer output. DxgkDdiQueryDirtyBitData memungkinkan kueri semua rentang basis memori atau satu.

Ketika memori tersedia, Dxgkrnl akan mencoba mempercepat operasi ini menggunakan satu panggilan untuk mengkueri semua data yang diperlukan sekaligus. Namun, dalam kondisi memori rendah, kemajuan penerusan menggunakan buffer berukuran tetap yang lebih kecil mungkin diperlukan, yang hanya merupakan subset yang lebih kecil dari basis memori yang dilacak dari panggilan sebelumnya ke DdiStartDirtyTracking. Rentang bitplane kotor yang diminta tidak akan pernah melebihi rentang kotor yang dilacak secara aktif.

Untuk informasi selengkapnya, lihat Pelacakan bit kotor.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 11, versi 24H2 (WDDM 3.2)
Header d3dkmddi.h
IRQL PASSIVE_LEVEL

Lihat juga

DXGKARG_QUERYDIRTYBITDATA