PAGP_COMMIT_VIRTUAL fungsi panggilan balik (videoagp.h)

Artikel
08/08/2023

Fungsi AgpCommitVirtual memetakan memori virtual yang dipesan ke rentang terkait dari alamat fisik yang dapat didekodekan AGP.

Sintaks

PAGP_COMMIT_VIRTUAL PagpCommitVirtual;

PVOID PagpCommitVirtual(
  [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 diperoleh dari AgpReserveVirtual.

[in] Pages

Menentukan jumlah halaman memori virtual yang akan dipetakan.

[in] Offset

Menentukan offset halaman untuk menerapkan halaman. Offset diterapkan ke rentang alamat virtual yang dipesan yang diidentifikasi oleh VirtualReserveContext.

Nilai kembali

AgpCommitVirtual mengembalikan alamat virtual untuk dasar halaman yang diterapkan jika pemetaan berhasil; jika tidak, mengembalikan NULL.

Keterangan

Sebelum memanggil AgpCommitVirtual untuk menerapkan rentang halaman virtual, Anda harus melakukan hal berikut:

Panggil AgpReservePhysical untuk memesan berbagai alamat fisik untuk digunakan GPU.
Panggil AgpCommitPhysical untuk memetakan sebagian (atau semua) alamat fisik yang dipesan ke halaman terkunci dalam memori sistem.
Panggil AgpReserveVirtual untuk memesan berbagai alamat virtual yang terkait dengan rentang alamat fisik yang disediakan oleh AgpReservePhysical.

Setelah item ini selesai, Anda dapat memanggil AgpCommitVirtual untuk memetakan sebagian halaman virtual yang dipesan ke halaman yang telah dipetakan dan dikunci oleh AgpCommitPhysical. Anda tidak boleh mencoba memetakan halaman alamat virtual jika halaman alamat fisik yang sesuai belum dipetakan.

Driver miniport video yang berjalan di Microsoft Windows 2000 harus selalu menerapkan rentang virtual yang ukurannya kelipatan 64 kilobyte. Jika Anda memanggil AgpCommitVirtual untuk menerapkan rentang virtual yang bukan kelipatan 64 kilobyte, AgpCommitVirtual dapat mengembalikan alamat virtual yang tidak valid.

Pada Windows XP dan yang lebih baru, AgpCommitVirtual secara otomatis memperluas rentang yang diterapkan sehingga merupakan kelipatan 64 kilobyte.

Ketika driver miniport memanggil AgpCommitVirtual, sebagian rentang alamat virtual yang diidentifikasi oleh VirtualReserveContext dipetakan ke alamat fisik. Bagian yang dipetakan memulai halaman Offset ke dalam rentang alamat virtual yang diidentifikasi oleh VirtualReserveContext.

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

AgpFreeVirtual

AgpReservePhysical

AgpReserveVirtual

Bagikan melalui