DXGKCB_ACQUIREHANDLEDATA回调函数 (d3dkmddi.h)

项目
02/23/2024

DXGKCB_ACQUIREHANDLEDATA 获取对分配的引用。

语法

DXGKCB_ACQUIREHANDLEDATA DxgkcbAcquirehandledata;

VOID * DxgkcbAcquirehandledata(
  [in]  IN_CONST_PDXGKARGCB_GETHANDLEDATA unnamedParam1,
  [out] PDXGKARG_RELEASE_HANDLE unnamedParam2
)
{...}

参数

[in] unnamedParam1

指向 描述DXGKCB_CREATECONTEXTALLOCATION 返回的分配句柄 的DXGKARGCB_GETHANDLEDATA结构的指针。

[out] unnamedParam2

指向释放分配引用时驱动程序使用的释放句柄的指针。

返回值

无。

备注

应用程序或用户模式驱动程序调用有效句柄上的 D3DKMTDestroyAllocation 可以随时销毁分配句柄。分配销毁涉及向内核模式驱动程序请求删除 Dxgkrnl 在分配创建期间返回给他们的分配对象，因此 KMD 最终可能会得到指向已释放内存的过时指针。 DXGKCB_ACQUIREHANDLEDATA 和 DXGKCB_RELEASEHANDLEDATA 允许驱动程序保留 对 Dxgkrnl 对象的引用，并确保 Dxgkrnl 在发出发布调用之前不会销毁分配和 KMD 关联的对象。

DXGKCB_XXX 函数由 Dxgkrnl 实现。若要使用此回调函数，请设置 DXGKARGCB_GETHANDLEDATA 的成员，然后通过 DXGKRNL_INTERFACE调用 DxgkCbAcquireHandleData。