PAGP_RESERVE_VIRTUAL fungsi panggilan balik (videoagp.h)

Artikel
08/08/2023

Fungsi AgpReserveVirtual mencadangkan berbagai alamat virtual untuk AGP.

Sintaks

PAGP_RESERVE_VIRTUAL PagpReserveVirtual;

PVOID PagpReserveVirtual(
  [in]  IN PVOID HwDeviceExtension,
  [in]  IN HANDLE ProcessHandle,
  [in]  IN PVOID PhysicalReserveContext,
  [out] OUT PVOID *VirtualReserveContext
)
{...}

Parameter

[in] HwDeviceExtension

Arahkan ke ekstensi perangkat driver miniport.

[in] ProcessHandle

Tangani proses untuk memesan rentang alamat virtual. Jika ProcessHandle adalah 0, maka rentang alamat virtual dialokasikan di ruang sistem.

[in] PhysicalReserveContext

Adalah handel konteks yang mengidentifikasi rentang alamat fisik yang dipesan untuk mengaitkan reservasi memori virtual. Konteks ini diperoleh dari AgpReservePhysical.

[out] VirtualReserveContext

Adalah lokasi di mana driver port video menulis handel konteks yang mengidentifikasi memori virtual yang dipesan.

Nilai kembali

AgpReserveVirtual mengembalikan alamat dasar rentang alamat virtual yang dipesan jika berhasil; jika tidak, mengembalikan NULL.

Keterangan

Jika ProcessHandle bukan 0, maka AgpReserveVirtual mencadangkan , tetapi tidak menerapkan, berbagai alamat virtual dalam ruang alamat proses mode pengguna. Dalam hal ini, Anda harus memanggil AgpCommitVirtual untuk memetakan alamat virtual yang dipesan (mode pengguna) ke alamat fisik.

Jika ProcessHandle adalah 0, maka AgpReserveVirtual mengalokasikan berbagai alamat virtual di ruang sistem dan secara otomatis memetakan (menerapkan) seluruh rentang alamat virtual ke alamat fisik. Meskipun AgpReserveVirtual menerapkan seluruh rentang virtual, Anda masih harus memanggil AgpCommitVirtual sebelum kode apa pun mengakses rentang virtual.

Saat Anda memanggil AgpReserveVirtual untuk mengalokasikan berbagai alamat virtual di ruang sistem (yaitu, jika Anda mengatur ProcessHandle ke 0), seluruh rentang alamat fisik yang diidentifikasi oleh PhysicalReserveContext harus diterapkan ke halaman memori fisik yang terkunci dengan panggilan sebelumnya ke AgpCommitPhysical.

Driver miniport dapat memanggil AgpReleaseVirtual beberapa kali untuk memesan banyak rentang alamat yang lebih kecil daripada satu rentang besar.

Driver miniport harus memanggil AgpReleaseVirtual untuk merilis rentang alamat virtual yang dipesan ketika tidak lagi diperlukan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows 2000 dan versi yang lebih baru dari sistem operasi Windows.
Target Platform	Desktop
Header	videoagp.h (sertakan Video.h)
IRQL	PASSIVE_LEVEL

Lihat juga

Bagikan melalui