Edit

DXGKARGCB_DESTROY_PHYSICAL_MEMORY_OBJECT structure (d3dkmddi.h)

  • Article

The DXGKARGCB_DESTROY_PHYSICAL_MEMORY_OBJECT structure contains the information used by the DXGKCB_DESTROYPHYSICALMEMORYOBJECT callback function to destroy physical memory.

Syntax

typedef struct _DXGKARGCB_DESTROY_PHYSICAL_MEMORY_OBJECT {
  [in] HANDLE hPhysicalMemoryObject;
  [in] HANDLE hAdapterMemoryObject;
} DXGKARGCB_DESTROY_PHYSICAL_MEMORY_OBJECT;

Members

[in] hPhysicalMemoryObject

Handle to the physical memory object created via DXGKCB_CREATEPHYSICALMEMORYOBJECT to destroy.

[in] hAdapterMemoryObject

Optional handle to an adapter memory object to close at the same time. This handle is provided for the purpose of creating a convenient mirror mapping with destroy. If hAdapterMemoryObject is not NULL, the driver must not also call DXGKCB_CLOSEPHYSICALMEMORYOBJECT.

Remarks

If the driver attempts to destroy a physical object that still has an existing ADL created against it, the call will bugcheck the machine since the driver is leaking locked pages.

See IOMMU DMA remapping for more information.

Requirements

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

See also

DXGKCB_CLOSEPHYSICALMEMORYOBJECT

DXGKCB_CREATEPHYSICALMEMORYOBJECT

DXGKCB_DESTROYPHYSICALMEMORYOBJECT