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

另请参阅

AgpFreePool

AgpSetCommand

DXGK_AGP_INTERFACE

DxgkCbQueryServices