PAGP_RESERVE_VIRTUAL fungsi panggilan balik (videoagp.h)
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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk