PAGP_FREE_VIRTUAL videoagp.h (回呼函式)
AgpFreeVirtual 函式會釋放先前呼叫 AgpCommitVirtual 所認可的虛擬記憶體。
語法
PAGP_FREE_VIRTUAL PagpFreeVirtual;
void PagpFreeVirtual(
[in] IN PVOID HwDeviceExtension,
[in] IN PVOID VirtualReserveContext,
[in] IN ULONG Pages,
[in] IN ULONG Offset
)
{...}
參數
[in] HwDeviceExtension
迷你埠驅動程式裝置延伸模組的指標。
[in] VirtualReserveContext
識別保留的虛擬位址範圍。 此內容句柄是從 AgpReserveVirtual 取得。
[in] Pages
指定視訊埠驅動程序應該取消對應的虛擬記憶體分頁數。
[in] Offset
指定要取消對應虛擬記憶體之實際基位址的 VirtualReserveContext 所識別之保留虛擬位址範圍的分頁位移。
傳回值
無
備註
當迷你埠驅動程式呼叫 AgpFreeVirtual時， 虛擬地址的頁面頁面會取消對應。 未對應的範圍會開始 位移 頁面到與 VirtualReserveContext 相關聯的範圍。 迷你埠驅動程序必須指定在呼叫 AgpCommitVirtual 之前已認可的確切位移和分頁數目。
對 AgpFreeVirtual 的呼叫必須與先前對 AgpCommitVirtual 的呼叫配對，而且對 AgpCommitVirtual 的呼叫之前必須加上 AgpReserveVirtual 的成功呼叫。 如果 AgpReserveVirtual 失敗 (傳回 NULL) ，您不得呼叫 AgpCommitVirtual 或 AgpFreeVirtual。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 適用於 Windows 2000 和更新版本的 Windows 作業系統。 |
| 目標平台 | 桌面 |
| 標頭 | videoagp.h (包含 Video.h) |
| IRQL | PASSIVE_LEVEL |