DXGKCB_FREECONTIGUOUSMEMORY callback function (d3dkmddi.h)

Article
10/21/2021

DXGKCB_FREECONTIGUOUSMEMORY frees a range of physically contiguous memory that was allocated by DXGKCB_ALLOCATECONTIGUOUSMEMORY.

Syntax

DXGKCB_FREECONTIGUOUSMEMORY DxgkcbFreecontiguousmemory;

NTSTATUS DxgkcbFreecontiguousmemory(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARGCB_FREECONTIGUOUSMEMORY pFreeContiguousMemory
)
{...}

Parameters

[in] hAdapter

Handle to a display adapter.

[in] pFreeContiguousMemory

Pointer to a DXGKARGCB_FREECONTIGUOUSMEMORY structure that contains a handle to the contiguous memory to be freed.

Return value

Return STATUS_SUCCESS if the operation succeeds. Otherwise, return an appropriate NTSTATUS error code.

Remarks

DXGKCB_XXX functions are implemented by Dxgkrnl. To use this callback function, set the members of DXGKARGCB_FREECONTIGUOUSMEMORY and then call DxgkCbFreeContiguousMemory via the DXGKRNL_INTERFACE.

See IOMMU-based GPU isolation for more information.

Requirements

Requirement	Value
Minimum supported client	Windows 10, version 1803 (WDDM 2.4)
Header	d3dkmddi.h
IRQL	PASSIVE_LEVEL