DXGKDDI_DESTROYALLOCATION回调函数 (d3dkmddi.h)

项目
02/26/2024

DxgkDdiDestroyAllocation 函数释放分配。

语法

DXGKDDI_DESTROYALLOCATION DxgkddiDestroyallocation;

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

参数

[in] hAdapter

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

[in] pDestroyAllocation

指向 DXGKARG_DESTROYALLOCATION 结构的指针，该结构包含用于释放分配的信息。

返回值

DxgkDdiDestroyAllocation 返回STATUS_SUCCESS，如果未成功释放分配，则返回相应的错误结果。

注解

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

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

DxgkDdiDestroyAllocation 应设为可分页。