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 |