PAGP_COMMIT_PHYSICAL 回调函数 (videoagp.h)

  • 项目

AgpCommitPhysical 函数将系统 (物理) 内存映射到指定的 AGP 可解码物理地址范围。

语法

PAGP_COMMIT_PHYSICAL PagpCommitPhysical;

BOOLEAN PagpCommitPhysical(
  [in] IN PVOID HwDeviceExtension,
  [in] IN PVOID PhysicalReserveContext,
  [in] IN ULONG Pages,
  [in] IN ULONG Offset
)
{...}

参数

[in] HwDeviceExtension

指向微型端口驱动程序的设备扩展的指针。

[in] PhysicalReserveContext

标识保留的物理地址范围。 上下文句柄是从 AgpReservePhysical 获取的。

[in] Pages

指定要提交的系统内存页数。

[in] Offset

指定提交页面的页偏移量。 偏移量应用于与 PhysicalReserveContext 关联的保留物理地址范围。

返回值

如果映射成功，则 AgpCommitPhysical 返回 TRUE，否则返回 FALSE。

注解

视频微型端口驱动程序必须先通过调用 AgpReservePhysical 来保留物理地址，然后才能调用此函数。

请勿调用 AgpCommitPhysical 来提交已提交的地址。 如果 PhysicalReserveContext、 Pages 和 Offset 指定的页面范围包括以前提交的任何页面， 则 AgpCommitPhysical 可能会失败。

在 Microsoft Windows 2000 上运行的视频微型端口驱动程序应始终保留并提交大小为 64 KB 的倍数的物理范围。 保留或提交不是 64 KB 的倍数的物理范围可能会导致 AgpReserveVirtual 或 AgpCommitVirtual 返回无效的虚拟地址。

在 Windows XP 及更高版本上， AgpCommitPhysical 会自动扩展提交的范围，使其为 64 KB 的倍数。

当视频微型端口驱动程序调用 AgpCommitPhysical 时， PhysicalReserveContext 标识的一部分物理地址范围映射到锁定的物理内存页。 映射部分开始 偏移 页到 由 PhysicalReserveContext 标识的范围。 视频微型端口驱动程序可以访问提交的物理内存，就像它是连续的一样。

要求

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

另请参阅

AgpCommitVirtual

AgpReservePhysical

AgpReserveVirtual