DXGKCB_ALLOCATEADL fungsi panggilan balik (d3dkmddi.h)
DXGKCB_ALLOCATEADL membuat daftar pendeskripsi alamat (ADL).
Sintaks
DXGKCB_ALLOCATEADL DxgkcbAllocateadl;
NTSTATUS DxgkcbAllocateadl(
[in/out] IN_OUT_PDXGKARGCB_ALLOCATE_ADL pArgs
)
{...}
Parameter
[in/out] pArgs
Arahkan ke struktur DXGKARGCB_ALLOCATE_ADL yang berisi informasi tentang ADL yang akan dibuat. Setelah berhasil, mengembalikan struktur DXGK_ADL dengan daftar alamat halaman yang dapat digunakan untuk memprogram perangkat keras.
Menampilkan nilai
Mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, mengembalikan kode kesalahan NTSTATUS yang sesuai, seperti STATUS_INVALID_PARAMETER.
Keterangan
Fungsi DXGKCB_ALLOCATEADL dan DXGKCB_FREEADL digunakan untuk membuat dan menghancurkan ADL yang menjelaskan alamat memori yang dapat diprogram (dipetakan) ke GPU. Memori yang mendasar dapat menunjuk ke memori logis atau fisik tergantung pada apakah IOMMU sedang digunakan, sehingga driver tidak boleh mencoba mengasumsikan bahwa alamat ini mewakili halaman fisik.
Ketika ADL dialokasikan dari objek fisik, Dxgkrnl menjamin bahwa memori ini tetap terkunci dan tidak dapat di-pageable untuk masa pakai ADL.
Lihat Remapping IOMMU DMA untuk informasi selengkapnya.
DXGKCB_XXX diimplementasikan oleh Dxgkrnl. Untuk menggunakan fungsi panggilan balik ini, atur anggota DXGKARGCB_ALLOCATE_ADL yang sesuai lalu panggil DxgkCbAllocateAdl melalui DXGKRNL_INTERFACE.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Server minimum yang didukung | Windows Server 2022 (WDDM 2.9) |
| Header | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |