структура DXGKARGCB_SAVEMEMORYFORHOTUPDATE (d3dkmddi.h)

Статья
02/06/2025

Структура DXGKARGCB_SAVEMEMORYFORHOTUPDATE содержит сведения, используемые функцией обратного вызова DXGKCB_SAVEMEMORYFORHOTUPDATE для сохранения памяти для горячего обновления драйвера.

Синтаксис

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;

Члены

[in] NumDataMemoryRanges

Количество диапазонов физической памяти в массиве pDataMemoryRanges.

[in, pDataMemoryRanges

Указатель на массив диапазонов физической памяти.

[in, pDataMdl

Указатель на список дескрипторов памяти (MDL), описывающий страницы физической памяти.

При передаче pDataMdlдрайвер должен выполнить следующее:

Вычисление объема памяти для выделения
MmAllocatePagesForMdlEx
MmMapLockedPagesSpecifyCache
Копирование описания данных в буфер
Копирование данных на страницы из внутренних структур данных
MmUnmapLockedPages
Предоставление MDL Dxgkrnl

[in] DataSize

Количество байтов в буфере, на который pData.

[in, pData

Указатель на виртуальную память для сохранения.

[in] MetaDataSize

Количество байтов в буфере, на который pMetaData.

[in, pMetaData

Указатель виртуальной памяти на метаданные, связанные с сохраненным блоком памяти.

Замечания

Драйвер не должен сохранять одну и ту же физическую страницу дважды.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 10 версии 1903 (WDDM 2.6)
заголовка	d3dkmddi.h

См. также

DXGKCB_SAVEMEMORYFORHOTUPDATE

Поделиться через