PAGP_FREE_VIRTUAL fungsi panggilan balik (videoagp.h)
Fungsi AgpFreeVirtual membebaskan memori virtual yang dilakukan oleh panggilan sebelumnya ke AgpCommitVirtual.
Sintaks
PAGP_FREE_VIRTUAL PagpFreeVirtual;
void PagpFreeVirtual(
[in] IN PVOID HwDeviceExtension,
[in] IN PVOID VirtualReserveContext,
[in] IN ULONG Pages,
[in] IN ULONG Offset
)
{...}
Parameter
[in] HwDeviceExtension
Arahkan ke ekstensi perangkat driver miniport.
[in] VirtualReserveContext
Mengidentifikasi rentang alamat virtual yang dipesan. Handel konteks ini diperoleh dari AgpReserveVirtual.
[in] Pages
Menentukan jumlah halaman memori virtual yang harus tidak di-unmap oleh driver port video.
[in] Offset
Menentukan offset halaman ke dalam rentang alamat virtual yang dipesan yang diidentifikasi oleh VirtualReserveContext yang menunjukkan alamat dasar aktual untuk membatalkan peta memori virtual.
Nilai kembali
Tidak ada
Keterangan
Saat driver miniport memanggil AgpFreeVirtual, halaman Halaman alamat virtual tidak dipetakan. Rentang yang tidak dipetakan memulai halaman Offset ke dalam rentang yang terkait dengan VirtualReserveContext. Driver miniport harus menentukan bahwa offset yang tepat dan jumlah halaman yang dibebaskan seperti yang dilakukan dalam panggilan sebelumnya ke AgpCommitVirtual.
Panggilan ke AgpFreeVirtual harus dipasangkan dengan panggilan sebelumnya ke AgpCommitVirtual, dan panggilan ke AgpCommitVirtual harus didahului dengan panggilan yang berhasil ke AgpReserveVirtual. Jika AgpReserveVirtual gagal (mengembalikan NULL), Anda tidak boleh memanggil AgpCommitVirtual atau AgpFreeVirtual.
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 |