DXGKDDI_DESTROYCPUEVENT - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers
// d3dkmddi.h

DXGKDDI_DESTROYCPUEVENT DxgkddiDestroycpuevent;

NTSTATUS DxgkddiDestroycpuevent(
  IN_CONST_HANDLE hAdapter,
  IN_CONST_HANDLE hKmdCpuEvent
)
{...}
View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Windows Driver Kit DDI reference (nc-d3dkmddi-dxgkddi_destroycpuevent)

Description

DXGKDDI_DESTROYCPUEVENT destroys the specified kernel-mode driver (KMD) CPU object.

Parameters

hAdapter

[in] Handle to a KMD context that is associated with a display adapter. The display miniport driver previously provided this handle to Dxgkrnl in the MiniportDeviceContext output parameter of the DXGKDDI_ADD_DEVICE function.

hKmdCpuEvent

[in] KMD CPU event object handle, which was returned by KMD from DXGKDDI_CREATECPUEVENT.

Return value

DXGKDDI_DESTROYCPUEVENT returns STATUS_SUCCESS if it succeeds; otherwise, it returns one of the error codes defined in Ntstatus.h.

Remarks

The Dxgkrnl CPU event object cannot be used after this DDI is called. The driver must synchronize destruction with all calls to DXGKCB_SIGNALEVENT.

It is guaranteed that the OS will call this DDI to destroy KMD sync objects. Objects could be destroyed when a user-mode client destroys a sync object, when a process terminates, or when the adapter is stopped.

See Signaling a CPU event from KMD for more information.

See also

DXGKDDI_CREATECPUEVENT