DXGKDDI_DESTROYALLOCATION回调函数 (d3dkmddi.h)

DxgkDdiDestroyAllocation 函数释放分配。

语法

DXGKDDI_DESTROYALLOCATION DxgkddiDestroyallocation;

NTSTATUS DxgkddiDestroyallocation(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_DESTROYALLOCATION pDestroyAllocation
)
{...}

参数

[in] hAdapter

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

[in] pDestroyAllocation

指向 DXGKARG_DESTROYALLOCATION 结构的指针,其中包含用于释放分配的信息。

返回值

DxgkDdiDestroyAllocation 返回STATUS_SUCCESS;如果未成功释放分配,则返回适当的错误结果。

言论

当用户模式显示驱动程序调用 pfnDeallocateCb 函数时,DirectX 图形内核子系统(即 Dxgkrnl.sys的一部分)调用显示微型端口驱动程序的 DxgkDdiDestroyAllocation 函数以释放分配。 显示微型端口驱动程序应清理其内部数据结构和对分配的引用。 Microsoft Direct3D 运行时启动对视频内存管理器(也是 Dxgkrnl.sys的一部分)的调用,然后调用 GPU 计划程序(这也是 Dxgkrnl.sys的一部分),以在实际释放视频内存之前同步。

显示微型端口驱动程序可以释放整个资源以及分配。 若要确定是否应释放资源,显示微型端口驱动程序可以检查 DestroyResource 标志是否在 标志pDestroyAllocation 参数指向的 DXGKARG_DESTROYALLOCATION 结构的成员中设置。 若要释放资源,显示微型端口驱动程序必须清理 hResource DXGKARG_DESTROYALLOCATION指定成员的句柄。 如果显示微型端口驱动程序未释放资源,驱动程序可以根据需要更改 hResource 中的值。

DxgkDdiDestroyAllocation 进行分页。

要求

要求 价值
最低支持的客户端 Windows Vista
目标平台 桌面
标头 d3dkmddi.h
IRQL PASSIVE_LEVEL

另请参阅

DXGKARG_DESTROYALLOCATION

DxgkDdiAddDevice

pfnDeallocateCb