DXGKCB_ACQUIREHANDLEDATA回调函数 (d3dkmddi.h)

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_ACQUIREHANDLEDATADXGKCB_RELEASEHANDLEDATA 允许驱动程序在 Dxgkrnl 对象上保存引用,并确保 Dxgkrnl 不会销毁分配和 KMD 关联的对象,直到发布调用之后。

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

要求

   
最低受支持的客户端 Windows 10 (WDDM 2.0)
Header d3dkmddi.h
IRQL <= APC_LEVEL

另请参阅

DXGKARGCB_GETHANDLEDATA

DXGKCB_CREATECONTEXTALLOCATION

DXGKCB_RELEASEHANDLEDATA

DXGKRNL_INTERFACE