DXGKCB_MAPPHYSICALMEMORY callback function (d3dkmddi.h)
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 |