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

  • Статья

Структура 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