DXGKCB_MAPCONTEXTALLOCATION callback function (d3dkmddi.h)

Article
02/22/2024

A kernel-mode display miniport driver calls DXGKCB_MAPCONTEXTALLOCATION to map a graphics processing unit (GPU) virtual address to the specified context allocation.

Syntax

DXGKCB_MAPCONTEXTALLOCATION DxgkcbMapcontextallocation;

D3DGPU_VIRTUAL_ADDRESS DxgkcbMapcontextallocation(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARGCB_MAPCONTEXTALLOCATION pArgs
)
{...}

Parameters

[in] hAdapter

A handle to the display adapter.

[in] pArgs

Pointer to a DXGKARGCB_MAPCONTEXTALLOCATION structure that describes the operation.

Return value

DXGKCB_MAPCONTEXTALLOCATION returns a D3DGPU_VIRTUAL_ADDRESS if successful, NULL otherwise.

Remarks

This device driver interface (DDI) behaves like its user-mode counterpart; see pfnMapGpuVirtualAddressCb for more details.

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

Requirements

Requirement	Value
Minimum supported client	Windows 10 (WDDM 2.0)
Minimum supported server	Windows Server 2016
Target Platform	Desktop
Header	d3dkmddi.h (include D3dkmddi.h)
IRQL	PASSIVE_LEVEL