DXGKCB_ALLOCATEPAGESFORMDL fungsi panggilan balik (d3dkmddi.h)

Artikel
02/23/2024

DXGKCB_ALLOCATEPAGESFORMDL mengalokasikan halaman memori fisik untuk daftar deskriptor memori (MDL) yang akan dipetakan ke ruang alamat logis IOMMU.

Sintaks

DXGKCB_ALLOCATEPAGESFORMDL DxgkcbAllocatepagesformdl;

NTSTATUS DxgkcbAllocatepagesformdl(
  [in]     IN_CONST_HANDLE hAdapter,
  [in/out] INOUT_PDXGKARGCB_ALLOCATEPAGESFORMDL pAllocatePagesForMdl
)
{...}

Parameter

[in] hAdapter

Handel ke adaptor tampilan.

[in/out] pAllocatePagesForMdl

Penunjuk ke struktur DXGKARGCB_ALLOCATEPAGESFORMDL yang berisi argumen untuk mengalokasikan halaman untuk MDL.

Menampilkan nilai

Mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, kembalikan kode kesalahan NTSTATUS yang sesuai.

Keterangan

Fungsi panggilan balik ini adalah fungsi driver port grafis Windows yang setara dengan fungsi MmAllocatePagesForMdl.

DXGKCB_XXX diimplementasikan oleh Dxgkrnl. Untuk menggunakan fungsi panggilan balik ini, atur anggota DXGKARGCB_ALLOCATEPAGESFORMDL yang sesuai lalu panggil DxgkCbAllocatePagesForMdl melalui DXGKRNL_INTERFACE.

Semua memori yang diakses oleh GPU selama operasi paging, atau dipetakan melalui GpuMmu harus dipetakan ke IOMMU. Dxgkrnl menyediakan panggilan balik ke driver mode kernel untuk memungkinkan alokasi dan remapping dalam satu langkah.

Catatan

Panggilan ke DXGKCB_ALLOCATEPAGESFORMDL terbatas pada pembatasan MDL PAGE_SIZE 4GB, dan Dxgkrnl selalu menentukan bendera MM_ALLOCATE_FULLY_REQUIRED dalam panggilan internal ke fungsi MmAllocatePagesForMdlEx. Driver juga tidak boleh mengunci memori apa pun. Dxgkrnl akan mengelola halaman terkunci untuk driver, dan setelah memori dipetakan ulang, alamat logis halaman yang diberikan kepada driver mungkin tidak lagi cocok dengan alamat fisik.

Lihat Isolasi GPU berbasis IOMMU untuk informasi selengkapnya.