DXGKCB_OPENPHYSICALMEMORYOBJECT fungsi panggilan balik (d3dkmddi.h)

Artikel
02/23/2024

Driver miniport tampilan mode kernel memanggil DXGKCB_OPENPHYSICALMEMORYOBJECT untuk membuka objek memori fisik dan mengaitkannya dengan adaptor.

Sintaks

DXGKCB_OPENPHYSICALMEMORYOBJECT DxgkcbOpenphysicalmemoryobject;

NTSTATUS DxgkcbOpenphysicalmemoryobject(
  [in/out] IN_OUT_PDXGKARGCB_OPEN_PHYSICAL_MEMORY_OBJECT pArgs
)
{...}

Parameter

[in/out] pArgs

Arahkan ke struktur DXGKARGCB_OPEN_PHYSICAL_MEMORY_OBJECT yang berisi informasi tentang objek memori fisik untuk dibuka.

Menampilkan nilai

DXGKCB_OPENPHYSICALMEMORYOBJECT mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, mengembalikan kode kesalahan NTSTATUS yang sesuai.

Keterangan

Untuk membuat daftar deskriptor alamat (ADL) dari objek memori fisik, daftar tersebut harus terlebih dahulu dikaitkan dengan adaptor. Ini biasanya dilakukan ketika objek memori fisik dibuat dengan menentukan parameter hAdapter dalam panggilan ke DXGKCB_CREATEPHYSICALMEMORYOBJECT. Namun, dalam beberapa kasus, handel adaptor tidak tersedia pada saat memori dialokasikan (misalnya, di awal proses boot). Dalam hal ini, driver harus memanggil DXGKCB_OPENPHYSICALMEMORYOBJECT untuk mengaitkan objek memori fisik dengan adaptor sebelum memanggil DXGKCB_ALLOCATEADL.

Lihat remapping IOMMU DMA untuk informasi selengkapnya.

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