DXGKCB_ALLOCATECONTIGUOUSMEMORY fungsi panggilan balik (d3dkmddi.h)

Artikel
03/08/2023

DXGKCB_ALLOCATECONTIGUOUSMEMORY mengalokasikan wilayah memori yang bersebelahan di ruang alamat logis IOMMU.

Sintaks

DXGKCB_ALLOCATECONTIGUOUSMEMORY DxgkcbAllocatecontiguousmemory;

NTSTATUS DxgkcbAllocatecontiguousmemory(
  [in]     IN_CONST_HANDLE hAdapter,
  [in/out] INOUT_PDXGKARGCB_ALLOCATECONTIGUOUSMEMORY pAllocateContiguousMemory
)
{...}

Parameter

[in] hAdapter

Menangani adaptor tampilan.

[in/out] pAllocateContiguousMemory

Penunjuk ke struktur DXGKARGCB_ALLOCATECONTIGUOUSMEMORY yang berisi argumen untuk mengalokasikan memori yang berdampingan.

Menampilkan nilai

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

Keterangan

Fungsi panggilan balik ini setara dengan fungsi MmAllocateContiguousMemory.

DXGKCB_XXX diimplementasikan oleh Dxgkrnl. Untuk menggunakan fungsi panggilan balik ini, atur anggota DXGKARGCB_ALLOCATECONTIGUOUSMEMORY yang sesuai lalu panggil DxgkCbAllocateContiguousMemory 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 KMD untuk memungkinkan alokasi dan remapping dalam satu langkah.

Catatan

Driver 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.