DXGKDDI_DESCRIBEALLOCATION回调函数（d3dkmddi.h）

项目
02/06/2025

DxgkDdiDescribeAllocation 函数检索有关现有分配的信息，该分配不适用于 Microsoft DirectX 图形内核子系统。

语法

DXGKDDI_DESCRIBEALLOCATION DxgkddiDescribeallocation;

NTSTATUS DxgkddiDescribeallocation(
  [in]     IN_CONST_HANDLE hAdapter,
  [in/out] INOUT_PDXGKARG_DESCRIBEALLOCATION pDescribeAllocation
)
{...}

参数

[in] hAdapter

与显示适配器关联的上下文块的句柄。显示微型端口驱动程序以前向 MiniportDeviceContext 中的 DirectX 图形内核子系统提供了此句柄，DxgkDdiAddDevice 函数的输出参数。

[in/out] pDescribeAllocation

指向描述现有分配的 DXGKARG_DESCRIBEALLOCATION 结构的指针。

返回值

DxgkDdiDescribeAllocation 如果成功，则返回STATUS_SUCCESS;否则，它将返回 Ntstatus.h中定义的错误代码之一。

言论

由于 DirectX 图形内核子系统不一定维护分配记录，因此图形内核子系统调用 DxgkDdiDescribeAllocation 请求显示微型端口驱动程序返回有关现有分配的信息。目前，显示微型端口驱动程序必须能够为以下分配返回此信息：

也是主要分配（也就是说，通过在调用 pfnAllocateCb 函数时，在 标志中设置主位字段标志D3DDDI_ALLOCATIONINFO 结构成员创建的用户模式显示驱动程序）。
可能是演示文稿源的分配（即调用显示微型端口驱动程序 DxgkDdiPresent 函数中由 DXGKARG_PRESENThSource 成员表示的分配）。

应 DxgkDdiDescribeAllocation 进行分页。