通过

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时，页 虚拟地址的页面未映射。 未映射的范围开始 Offset 页面进入与 virtualReserveContext关联的区域。 微型端口驱动程序必须指定在调用 AgpCommitVirtual之前提交的确切偏移量和页数。

对 AgpFreeVirtual 的调用必须与对 AgpCommitVirtual的上一次调用配对，并且对 AgpCommitVirtual 的调用必须前面是成功调用 AgpReserveVirtual。 如果 AgpReserveVirtual 失败（返回 NULL），则不得调用 AgpCommitVirtual 或 AgpFreeVirtual。

要求

要求 价值
最低支持的客户端 在 Windows 2000 及更高版本的 Windows作系统中可用。
目标平台 桌面
标头 videoagp.h （包括 Video.h）
IRQL PASSIVE_LEVEL

另请参阅

AgpCommitVirtual