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 结构的 Context 成员中收到此句柄。
[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 |