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

另請參閱

AgpCommitVirtual