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


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

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

Синтаксис

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

[in/out] Указатель на структуру 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