DXGKDDI_DESTROYCPUEVENT回调函数 (d3dkmddi.h)

DXGKDDI_DESTROYCPUEVENT (KMD) CPU 对象销毁指定的内核模式驱动程序。

语法

DXGKDDI_DESTROYCPUEVENT DxgkddiDestroycpuevent;

NTSTATUS DxgkddiDestroycpuevent(
  IN_CONST_HANDLE hAdapter,
  IN_CONST_HANDLE hKmdCpuEvent
)
{...}

hAdapter

[in]与显示适配器关联的 KMD 上下文的句柄。显示微型端口驱动程序之前在 DXGKDDI_ADD_DEVICE 函数的 MiniportDeviceContext 输出参数中向 Dxgkrnl 提供了此句柄。

hKmdCpuEvent

[in]KMD CPU 事件对象句柄，KMD 从 DXGKDDI_CREATECPUEVENT 返回。

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

调用此 DDI 后，无法使用 Dxgkrnl CPU 事件对象。驱动程序必须将销毁与对 DXGKCB_SIGNALEVENT 的所有调用同步。

可以保证 OS 会调用此 DDI 来销毁 KMD 同步对象。当用户模式客户端销毁同步对象、进程终止或适配器停止时，对象可能会被销毁。