PAGP_RESERVE_PHYSICAL回呼函式 （videoagp.h）
AgpReservePhysical 函式會在 AGP 控制器可以回應的系統總線上保留一系列實體位址。
語法
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
)
{...}
參數
[in] HwDeviceExtension
迷你埠驅動程式裝置延伸模組的指標。
[in] Pages
指定視訊埠驅動程式應保留的頁面數目。
[in] Caching
VIDEO_PORT_CACHE_TYPE 列舉，指定系統應該使用的快取類型。
[out] PhysicalReserveContext
指定視訊埠驅動程式寫入內容句柄的位置，以識別保留的實體地址空間。
傳回值
AgpReservePhysical 如果成功，會傳回保留實體位址範圍的基位址;否則會傳回 NULL。
言論
在 Windows 2000 上執行的視訊迷你埠驅動程式應該一律保留大小為 64 KB 的倍數範圍。 保留不是 64 KB 之倍數的範圍可能會導致 AgpReserveVirtual 或 AgpCommitVirtual 傳回無效虛擬位址。
在 Windows XP 和更新版本上，AgpReservePhysical 會自動將要求的範圍擴充為 64 KB 的倍數。
成功傳回時，AGP 控制器可以回應總線上保留的實體位址範圍。 不過，視訊迷你埠驅動程序必須先呼叫 AgpCommitPhysical，才能認可此記憶體，才能定義存取的結果。
迷你埠驅動程式可以呼叫 AgpReservePhysical 數次，以保留許多較小的位址範圍，而不是一個大範圍。
迷你埠驅動程序應該呼叫 AgpReleasePhysical，以在不再需要實體位址範圍時釋出實體位址範圍。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 |
| 目標平臺 | 桌面 |
| 標頭 | videoagp.h （include Video.h） |
| IRQL | PASSIVE_LEVEL |