DXGKDDI_CREATEMEMORYBASIS fungsi panggilan balik (d3dkmddi.h)
Fungsi DxgkDdiCreateMemoryBasis KMD membuat handel untuk kumpulan rentang memori yang mewakili alokasi yang dioperasikan selama pelacakan bit kotor.
Sintaks
DXGKDDI_CREATEMEMORYBASIS DxgkddiCreatememorybasis;
HANDLE DxgkddiCreatememorybasis(
IN_CONST_HANDLE hAdapter,
IN_CONST_PDXGKARG_CREATEMEMORYBASIS 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
[in] Penunjuk ke struktur DXGKARG_CREATEMEMORYBASIS yang berisi informasi untuk dasar yang dibuat.
Menampilkan nilai
DxgkDdiCreateMemoryBasis mengembalikan HANDLE ke referensi KMD untuk melacak kumpulan rentang. KMD harus dapat mengubah informasi ini menjadi informasi dasar dalam perintah berikutnya seperti DxgkDdiDestroyMemoryBasis.
Keterangan
Pelacakan operasi modifikasi pada VRAM adalah untuk alokasi yang mungkin tidak didukung secara bersebelahan. Jadi alamat fisik yang diwakili dalam pelacakan bit kotor terdiri dari kumpulan rentang yang mewakili alokasi yang dioperasikan. DxgkDdiCreateMemoryBasis mengembalikan handel ke referensi KMD untuk melacak rentang ini.
KMD dapat mengandalkan invarian berikut:
Untuk setiap rentang dalam Rentang, baik SegmentOffset maupun (SegmentOffset + SizeInBytes - 1) mewakili alamat yang valid pada segmen yang dirujuk oleh SegmentId.
Semua Rentang berpasangan terputang; artinya, persimpangan antara dua rentang selalu null.
Juga umum bahwa SegmentOffset dan SizeInBytes akan menghormati perataan halaman tertentu ketika basis memori yang dibuat digunakan dalam DDI pelacakan kotor tertentu. Nilai-nilai ini dijelaskan pada halaman referensi DDI tersebut, dan selalu merupakan kelipatan DXGK_DIRTY_BIT_TRACKING_SEGMENT_CAPS::P ageSize.
Dxgkrnl sebaliknya tidak membuat jaminan tentang urutan alamat dalam pengumpulan Rentang atau jaminan terkait.
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 |