функция обратного вызова 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 |