DXGKCB_DESTROYCONTEXTALLOCATION callback function (d3dkmddi.h)

Article
02/22/2024

DXGKCB_DESTROYCONTEXTALLOCATION frees a resource that was previously allocated for a GPU or device-specific context.

Syntax

DXGKCB_DESTROYCONTEXTALLOCATION DxgkcbDestroycontextallocation;

NTSTATUS DxgkcbDestroycontextallocation(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_HANDLE hAllocation
)
{...}

Parameters

[in] hAdapter

Handle to the graphics adapter for which the allocation was created. The display miniport driver receives the handle from the DeviceHandle member of the DXGKRNL_INTERFACE structure in a call to its DxgkDdiStartDevice function.

[in] hAllocation

Handle that was assigned by the DirectX graphics subsystem (Dxgkrnl) to the context allocation. The display miniport driver receives the handle from the hAllocation member of the DXGKARGCB_CREATECONTEXTALLOCATION structure in a call to the DXGKCB_CREATECONTEXTALLOCATION function.

Return value

DXGKCB_DESTROYCONTEXTALLOCATION returns STATUS_SUCCESS if it succeeds. Otherwise, it returns one of the error codes defined in Ntstatus.h.

Remarks

The display miniport driver calls DXGKCB_CREATECONTEXTALLOCATION to allocate a context resource. After such a call, the driver can call DXGKCB_DESTROYCONTEXTALLOCATION at any time to free the resource.

DXGKCB_XXX functions are implemented by Dxgkrnl. To use this callback function, call DxgkCbDestroyContextAllocation via the DXGKRNL_INTERFACE.

Requirements

Requirement	Value
Minimum supported client	Windows 8 (WDDM 1.2)
Minimum supported server	Windows Server 2012
Target Platform	Desktop
Header	d3dkmddi.h (include D3dkmddi.h)
IRQL	PASSIVE_LEVEL