PAGP_RESERVE_PHYSICAL fungsi panggilan balik (videoagp.h)
Fungsi AgpReservePhysical mencadangkan berbagai alamat fisik pada bus sistem tempat pengontrol AGP dapat merespons.
Sintaks
PAGP_RESERVE_PHYSICAL PagpReservePhysical;
PHYSICAL_ADDRESS PagpReservePhysical(
[in] IN PVOID HwDeviceExtension,
[in] IN ULONG Pages,
[in] IN VIDEO_PORT_CACHE_TYPE Caching,
[out] OUT PVOID *PhysicalReserveContext
)
{...}
Parameter
[in] HwDeviceExtension
Arahkan ke ekstensi perangkat driver miniport.
[in] Pages
Menentukan jumlah halaman yang harus dicadangkan oleh pengandar porta video.
[in] Caching
Menentukan jenis penembolokan yang harus digunakan sistem. Parameter ini dapat diatur ke salah satu nilai berikut.
| Nilai | Makna |
|---|---|
| VpNonCached | Sistem tidak boleh menyimpan cache rentang alamat. |
| VpWriteCombined | Sistem harus menggunakan penembolokan write-combined (WC). Untuk informasi tentang penembolokan WC, lihat artikel situs web Write-Combining Memory in Video Miniport Drivers . |
| VpCached | Sistem harus menggunakan penembolokan biasa. |
[out] PhysicalReserveContext
Menentukan lokasi di mana driver port video menulis handel konteks yang mengidentifikasi ruang alamat fisik yang dipesan.
Nilai kembali
AgpReservePhysical mengembalikan alamat dasar rentang alamat fisik yang dipesan jika berhasil; jika tidak, ia mengembalikan NULL.
Keterangan
Driver miniport video yang berjalan di Microsoft Windows 2000 harus selalu memesan rentang yang ukurannya kelipatan 64 kilobyte. Mempertahankan rentang yang bukan kelipatan 64 kilobyte dapat mengakibatkan AgpReserveVirtual atau AgpCommitVirtual mengembalikan alamat virtual yang tidak valid.
Pada Microsoft Windows XP dan yang lebih baru, AgpReservePhysical secara otomatis memperluas rentang yang diminta ke kelipatan 64 kilobyte.
Setelah berhasil kembali, pengontrol AGP dapat merespons rentang alamat fisik yang dipesan di bus. Namun, driver miniport video harus terlebih dahulu memanggil AgpCommitPhysical untuk menyebabkan memori ini diterapkan sebelum mengaksesnya agar hasil yang diakses ditentukan.
Driver miniport dapat memanggil AgpReservePhysical beberapa kali untuk memesan banyak rentang alamat yang lebih kecil daripada satu rentang besar.
Driver miniport harus memanggil AgpReleasePhysical untuk merilis rentang alamat fisik 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 |