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