DXGKCB_CREATEPHYSICALMEMORYOBJECT callback function (d3dkmddi.h)

Article
06/25/2022

DXGKCB_CREATEPHYSICALMEMORYOBJECT creates physical memory for the driver.

Syntax

DXGKCB_CREATEPHYSICALMEMORYOBJECT DxgkcbCreatephysicalmemoryobject;

NTSTATUS DxgkcbCreatephysicalmemoryobject(
  [in/out] IN_OUT_PDXGKARGCB_CREATE_PHYSICAL_MEMORY_OBJECT pArgs
)
{...}

Parameters

[in/out] pArgs

Pointer to a DXGKARGCB_CREATE_PHYSICAL_MEMORY_OBJECT structure that contains information about the physical memory to create.

Return value

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

Remarks

DXGKCB_CREATEPHYSICALMEMORYOBJECT and DXGKCB_DESTROYPHYSICALMEMORYOBJECT create and destroy physical memory for the driver. Internally this memory can be represented in different forms, but will conform to the requirements and caching type specified in the arguments provided in DXGKARGCB_CREATE_PHYSICAL_MEMORY_OBJECT.

See IOMMU DMA remapping for more information.

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

Requirements

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