DXGKCB_AGP_ALLOCATE_POOL回调函数 （dispmprt.h）
DXGKCB_AGP_ALLOCATE_POOL 回调函数保留、提交和映射加速图形端口（AGP）内存。
语法
DXGKCB_AGP_ALLOCATE_POOL DxgkcbAgpAllocatePool;
NTSTATUS DxgkcbAgpAllocatePool(
[in] IN HANDLE Context,
[in] IN ULONG AllocationSize,
[in] IN MEMORY_CACHING_TYPE CacheType,
[out] OUT PPHYSICAL_ADDRESS PhysicalAddress,
[out] OUT PVOID *VirtualAddress
)
{...}
参数
[in] Context
与 AGP 接口关联的上下文块的句柄。 显示微型端口驱动程序以前在 上下文中收到此句柄，DxgkCbQueryServices填充的DXGK_AGP_INTERFACE结构的 成员。
[in] AllocationSize
要分配的 AGP 内存的大小（以字节为单位）。
[in] CacheType
MEMORY_CACHING_TYPE 枚举中的常量，指定 CPU 在访问分配的 AGP 内存时是否可以使用缓存或写入组合。
[out] PhysicalAddress
指向接收 AGP 分配的基本物理地址的PHYSICAL_ADDRESS结构的指针。 这是 GPU 用于访问 AGP 内存的物理地址范围的基数。
[out] VirtualAddress
指向在系统空间中接收 AGP 分配的基本虚拟地址的变量的指针。 这是 CPU 将用于访问 AGP 内存的虚拟地址范围的基数。
返回值
AgpAllocatePool 如果成功，则返回STATUS_SUCCESS。 否则，它将返回 Ntstatus.h中定义的错误代码之一。
言论
在显示微型端口驱动程序的 DxgkDdiStartDevice 函数中调用 AgpAllocatePool。 如果在 DxgkDdiStartDevice 执行后调用 AgpAllocatePool ，则可能 AgpAllocatePool 失败。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | Windows Vista |
| 目标平台 | 桌面 |
| 标头 | dispmprt.h （包括 Dispmprt.h） |
| IRQL | PASSIVE_LEVEL |