DXGKCB_DESTROYPHYSICALMEMORYOBJECT callback function (d3dkmddi.h)

Article
02/22/2024

DXGKCB_DESTROYPHYSICALMEMORYOBJECT destroys physical memory for the driver.

Syntax

DXGKCB_DESTROYPHYSICALMEMORYOBJECT DxgkcbDestroyphysicalmemoryobject;

void DxgkcbDestroyphysicalmemoryobject(
  [in] IN_CONST_PDXGKARGCB_DESTROY_PHYSICAL_MEMORY_OBJECT pArgs
)
{...}

Parameters

[in] pArgs

Pointer to a DXGKARGCB_DESTROY_PHYSICAL_MEMORY_OBJECT structure that contains information about the physical memory to destroy.

Return value

None

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 members of DXGKARGCB_DESTROY_PHYSICAL_MEMORY_OBJECT and then call DxgkCbDestroyPhysicalMemoryObject via the DXGKRNL_INTERFACE.

Requirements

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