DXGKCB_MAPPHYSICALMEMORY callback function (d3dkmddi.h)

Article
02/22/2024

A kernel-mode display miniport driver calls DXGKCB_MAPPHYSICALMEMORY to map CPU-visible virtual addresses to the underlying physical memory.

Syntax

DXGKCB_MAPPHYSICALMEMORY DxgkcbMapphysicalmemory;

NTSTATUS DxgkcbMapphysicalmemory(
  [in/out] IN_OUT_PDXGKARGCB_MAP_PHYSICAL_MEMORY pArgs
)
{...}

Parameters

[in/out] pArgs

Pointer to a DXGKARGCB_MAP_PHYSICAL_MEMORY structure that contains information about the physical memory to map.

Return value

DXGKCB_MAPPHYSICALMEMORY returns STATUS_SUCCESS if the operation succeeds. Otherwise, returns an appropriate NTSTATUS error code.

Remarks

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

The cache type used for the mappings will be based on the CacheType specified when the physical memory object was created in a call to DXGKCB_CREATEPHYSICALMEMORYOBJECT.

See IOMMU DMA remapping for more information.

Requirements

Requirement	Value
Minimum supported server	Windows Server 2022 (WDDM 2.9)
Header	d3dkmddi.h
IRQL	PASSIVE_LEVEL