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

Lihat juga

AgpCommitVirtual