DXGKCB_UPDATECONTEXTALLOCATION callback function (d3dkmddi.h)

Article
02/22/2024

DXGKCB_UPDATECONTEXTALLOCATION updates the content of a context allocation.

Syntax

DXGKCB_UPDATECONTEXTALLOCATION DxgkcbUpdatecontextallocation;

NTSTATUS DxgkcbUpdatecontextallocation(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARGCB_UPDATECONTEXTALLOCATION pArgs
)
{...}

Parameters

[in] hAdapter

A handle to the display adapter.

[in] pArgs

The DXGKARGCB_UPDATECONTEXTALLOCATION structure that describes the operation.

Return value

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

Remarks

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

The video memory manager maps the specified allocation in the paging process address space, then calls DXGKCB_UPDATECONTEXTALLOCATION to trigger a context allocation update paging operation, passing the kernel-mode display driver the specified driver private data.

The call to DXGKCB_UPDATECONTEXTALLOCATION returns when the update to the context allocation is completed.

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