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


функция обратного вызова DXGKDDI_SAVEMUTABLEMIGRATIONDATA (d3dkmddi.h)

Функция DxgkDdiSaveMutableMigrationData KMD собирает изменяемые данные для динамической миграции, которая вот-вот завершится.

Синтаксис

DXGKDDI_SAVEMUTABLEMIGRATIONDATA DxgkddiSavemutablemigrationdata;

NTSTATUS DxgkddiSavemutablemigrationdata(
  IN_CONST_HANDLE hAdapter,
  INOUT_PDXGKARG_GPUP_SAVE_MUTABLE_MIGRATION_DATA pArgs
)
{...}

Параметры

hAdapter

[in] Дескриптор для блока контекста, связанного с видеоадаптером. Драйвер мини-порта дисплея ранее предоставлял этот дескриптор dxgkrnl в выходном параметре MiniportDeviceContext функции DXGKDDI_ADD_DEVICE .

pArgs

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

Возвращаемое значение

DxgkDdiSaveMutableMigrationData возвращает STATUS_SUCCESS, если вызов выполнен успешно. В противном случае возвращается соответствующий код NTSTATUS.

Комментарии

DxgkDdiSaveMutableMigrationData вызывается для сбора изменяемых данных при завершении динамической миграции. Этот DDI следует вызывать только для виртуальных машин, которые в настоящее время приостановлены.

DxgkDdiSaveMutableMigrationData вызывается в классическом шаблоне динамического буфера:

  • При первом вызове dataSize имеет значение 0, а для Data — значение NULL. KMD должен изменить DataSize на общее количество байтов, необходимых для хранения неизменяемых данных.
  • Dxgkrnl создает буфер из байтов DataSize и выполняет второй вызов с параметром DataSize , равным значению, возвращенным KMD, и data , указывающим на выделенный буфер. Dxgkrnl управляет временем существования выделенной памяти после вызова.

DxgkDdiSaveImmutableMigrationData вызывается в начале динамической миграции для сбора неизменяемых данных.

Дополнительные сведения см. в разделе Динамическая миграция на устройствах GPU-P.

Требования

Требование Значение
Минимальная версия клиента Windows 11 версии 24H2 (WDDM 3.2)
Верхняя часть d3dkmddi.h
IRQL PASSIVE_LEVEL

См. также раздел

DXGKARG_GPUP_SAVE_MUTABLE_MIGRATION_DATA

DxgkDdiSaveImmutableMigrationData