DXGKARGCB_SAVEMEMORYFORHOTUPDATE structure (d3dkmddi.h)

The DXGKARGCB_SAVEMEMORYFORHOTUPDATE structure contains the information used by the DXGKCB_SAVEMEMORYFORHOTUPDATE callback function, to save memory for a driver hot update.

Syntax

typedef struct _DXGKARGCB_SAVEMEMORYFORHOTUPDATE {
  [in]           UINT                  NumDataMemoryRanges;
  [in, optional] DXGK_KSR_MEMORY_RANGE *pDataMemoryRanges;
  [in, optional] PMDL                  pDataMdl;
  [in]           UINT                  DataSize;
  [in, optional] PVOID                 pData;
  [in]           UINT                  MetaDataSize;
  [in, optional] BYTE                  *pMetaData;
} DXGKARGCB_SAVEMEMORYFORHOTUPDATE;

Members

[in] NumDataMemoryRanges

The number of physical memory ranges in the pDataMemoryRanges array.

[in, pDataMemoryRanges

Pointer to the array of physical memory ranges.

[in, pDataMdl

Pointer to a memory descriptor list (MDL) that describes the physical memory pages.

When passing pDataMdl, the driver should do the following:

• Compute how much memory to allocate
• MmAllocatePagesForMdlEx
• MmMapLockedPagesSpecifyCache
• Copy description of the data to the buffer
• Copy data into pages from internal data structures
• MmUnmapLockedPages
• Give MDL to Dxgkrnl

[in] DataSize

The number of bytes in the buffer that pData points to.

[in, pData

A pointer to the virtual memory to save.

[in] MetaDataSize

The number of bytes in the buffer that pMetaData points to.

[in, pMetaData

The virtual memory pointer to metadata that is associated with the saved memory block.

Remarks

The driver must not save the same physical page twice.

Requirements

Requirement	Value
Minimum supported client	Windows 10, version 1903 (WDDM 2.6)
Header	d3dkmddi.h

See also

DXGKCB_SAVEMEMORYFORHOTUPDATE