DXGKDDI_DESCRIBEALLOCATION回调函数 (d3dkmddi.h)

项目
02/23/2024

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

语法

DXGKDDI_DESCRIBEALLOCATION DxgkddiDescribeallocation;

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

参数

[in] hAdapter

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

[in/out] pDescribeAllocation

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

返回值

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

注解

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

也是主要 (的分配，即用户模式显示驱动程序通过在调用 pfnAllocateCb 函数) 中，在D3DDDI_ALLOCATIONINFO结构的 Flags 成员中设置 Primary 位字段标志创建的分配。
可能是表示 (的源的分配，即，在对显示微型端口驱动程序的 DxgkDdiPresent 函数的调用) 中由 DXGKARG_PRESENT 结构的 hSource 成员表示的分配。

DxgkDdiDescribeAllocation 应设为可分页。