PAGP_COMMIT_PHYSICAL fungsi panggilan balik (videoagp.h)

Artikel
08/08/2023

Fungsi AgpCommitPhysical memetakan memori sistem (fisik) ke rentang alamat fisik yang dapat didekodekan AGP yang ditentukan.

Sintaks

PAGP_COMMIT_PHYSICAL PagpCommitPhysical;

BOOLEAN PagpCommitPhysical(
  [in] IN PVOID HwDeviceExtension,
  [in] IN PVOID PhysicalReserveContext,
  [in] IN ULONG Pages,
  [in] IN ULONG Offset
)
{...}

Parameter

[in] HwDeviceExtension

Arahkan ke ekstensi perangkat driver miniport.

[in] PhysicalReserveContext

Mengidentifikasi rentang alamat fisik yang dipesan. Handel konteks diperoleh dari AgpReservePhysical.

[in] Pages

Menentukan jumlah halaman memori sistem yang akan diterapkan.

[in] Offset

Menentukan offset halaman untuk menerapkan halaman. Offset diterapkan ke rentang alamat fisik khusus yang terkait dengan PhysicalReserveContext.

Nilai kembali

AgpCommitPhysical mengembalikan TRUE jika pemetaan berhasil, dan FALSE sebaliknya.

Keterangan

Driver miniport video harus terlebih dahulu memesan alamat fisik dengan memanggil AgpReservePhysical sebelum memanggil fungsi ini.

Jangan panggil AgpCommitPhysical untuk menerapkan alamat yang telah diterapkan. Jika rentang halaman yang ditentukan oleh PhysicalReserveContext, Pages, dan Offset menyertakan halaman apa pun yang sebelumnya diterapkan, AgpCommitPhysical mungkin gagal.

Driver miniport video yang berjalan di Microsoft Windows 2000 harus selalu memesan dan menerapkan rentang fisik yang ukurannya kelipatan 64 kilobyte. Mempertahankan atau menerapkan rentang fisik yang bukan kelipatan 64 kilobyte dapat mengakibatkan AgpReserveVirtual atau AgpCommitVirtual mengembalikan alamat virtual yang tidak valid.

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

Ketika driver miniport video memanggil AgpCommitPhysical, sebagian dari rentang alamat fisik yang diidentifikasi oleh PhysicalReserveContext dipetakan ke halaman terkunci memori fisik. Bagian yang dipetakan memulai halaman Offset ke dalam rentang yang diidentifikasi oleh PhysicalReserveContext. Driver miniport video dapat mengakses memori fisik yang diterapkan seolah-olah berdada.

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

AgpReservePhysical

AgpReserveVirtual

Bagikan melalui