DXGKCB_AGP_ALLOCATE_POOL fungsi panggilan balik (dispmprt.h)

Artikel
02/23/2024

Fungsi panggilan balik DXGKCB_AGP_ALLOCATE_POOL mencadangkan, menerapkan, dan memetakan memori Port Grafis Dipercepat (AGP).

Sintaks

DXGKCB_AGP_ALLOCATE_POOL DxgkcbAgpAllocatePool;

NTSTATUS DxgkcbAgpAllocatePool(
  [in]  IN HANDLE Context,
  [in]  IN ULONG AllocationSize,
  [in]  IN MEMORY_CACHING_TYPE CacheType,
  [out] OUT PPHYSICAL_ADDRESS PhysicalAddress,
  [out] OUT PVOID *VirtualAddress
)
{...}

Parameter

[in] Context

Handel ke blok konteks yang terkait dengan antarmuka AGP. Driver miniport tampilan sebelumnya menerima handel ini di anggota Konteks struktur DXGK_AGP_INTERFACE yang diisi oleh DxgkCbQueryServices.

[in] AllocationSize

Ukuran, dalam byte, dari memori AGP yang akan dialokasikan.

[in] CacheType

Konstanta dari enumerasi MEMORY_CACHING_TYPE yang menentukan apakah CPU dapat menggunakan penembolokan atau penulisan yang dikombinasikan saat mengakses memori AGP yang dialokasikan.

[out] PhysicalAddress

Pointer ke struktur PHYSICAL_ADDRESS yang menerima alamat fisik dasar alokasi AGP. Ini adalah dasar rentang alamat fisik yang akan digunakan GPU untuk mengakses memori AGP.

[out] VirtualAddress

Pointer ke variabel yang menerima alamat virtual dasar, di ruang sistem, dari alokasi AGP. Ini adalah dasar rentang alamat virtual yang akan digunakan CPU untuk mengakses memori AGP.

Nilai kembali

AgpAllocatePool mengembalikan STATUS_SUCCESS jika berhasil. Jika tidak, ia mengembalikan salah satu kode kesalahan yang ditentukan dalam Ntstatus.h.

Keterangan

Panggil AgpAllocatePool dalam fungsi DxgkDdiStartDevice driver miniport tampilan. Kemungkinan AgpAllocatePool akan gagal jika Anda memanggilnya setelah DxgkDdiStartDevice dijalankan.