DXGKCB_RESERVEGPUVIRTUALADDRESSRANGE callback function (d3dkmddi.h)

Article
02/22/2024

A kernel-mode display miniport driver can call DXGKCB_RESERVEGPUVIRTUALADDRESSRANGE to reserve a graphics processing unit (GPU) virtual address range during creation of a process.

Syntax

DXGKCB_RESERVEGPUVIRTUALADDRESSRANGE DxgkcbReservegpuvirtualaddressrange;

NTSTATUS DxgkcbReservegpuvirtualaddressrange(
  [in]     IN_CONST_HANDLE hAdapter,
  [in/out] INOUT_PDXGKARGCB_RESERVEGPUVIRTUALADDRESSRANGE pArgs
)
{...}

Parameters

[in] hAdapter

A handle to the display adapter.

[in/out] pArgs

A DXGKARGCB_RESERVEGPUVIRTUALADDRESSRANGE structure that describes the operation.

Return value

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

Remarks

Reserving the GPU virtual address range is only possible during process creation (i.e. within the call to DxgkDdiCreateProcess) and is invalid at any other time.

Reservation is possible on both a regular process as well as the system process where the system device and context lives.

The first entry in the root page table (page table entry index 0) will always be initialized as invalid by the video memory manager and the driver reservations will start from page table entry index 1. Driver reservation must always be an exact multiple of virtual address space, covered by leaf page table, as the specific page table entry can’t be shared between the video memory manager and the kernel-mode driver. Page table entries reserved by the driver will be initialized as invalid by the video memory manager and may be overwritten by the driver to reference an internally allocated page table managed by the driver. The video memory manager will update the reserved page table entries as invalid every time the corresponding page table becomes resident.

DXGKCB_XXX functions are implemented by Dxgkrnl. To use this callback function, set the appropriate members of DXGKARGCB_RESERVEGPUVIRTUALADDRESSRANGE and then call DxgkCbReserveGpuVirtualAddressRange 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 Dispmprt.h)
IRQL	<= PASSIVE_LEVEL