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

Статья
02/07/2025

[Некоторые сведения связаны с предварительно выпущенным продуктом, который может быть существенно изменен до его коммерческого выпуска. Корпорация Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых в отношении информации, предоставленной здесь.]

Функция VmbChannelSaveContinue сохраняет состояние канала в буфер. Запустите VmbChannelSaveBegin перед выполнением этой функции. Драйвер должен проверить возвращаемое значение функции.

Синтаксис

FN_VMB_CHANNEL_SAVE_CONTINUE FnVmbChannelSaveContinue;

NTSTATUS FnVmbChannelSaveContinue(
  VMBCHANNEL Channel,
  PVOID SaveBuffer,
  ULONG SaveBufferSize,
  PULONG BytesFilled,
  PULONG BytesRequired
)
{...}

Параметры

Channel

Дескриптор для сохранения канала.

SaveBuffer

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

SaveBufferSize

Размер буфера сохранения в байтах.

BytesFilled

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

BytesRequired

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

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

VmbChannelSaveContinue возвращает следующие значения:

Возвращаемый код	Описание
STATUS_SUCCESS	Состояние сохранено.
STATUS_BUFFER_TOO_SMALL	Буфер сохранения слишком мал. Параметр BytesNeeded содержит количество байтов, необходимых для выполнения любого хода выполнения.
STATUS_STATUS_BUFFER_OVERFLOW	Некоторые данные были записаны в буфер сохранения, но есть больше данных для сохранения.

Замечания

Процесс сохранения сохраняет данные в блоках и может продолжаться с точки ее остановки.

Если вызывающий объект заранее не выделил достаточно места, может потребоваться несколько вызовов.

Важный

Эта функция вызывается через клиентский интерфейс клиентской библиотеки режима ядра VMBus (KMCL), предоставляемый драйвером шины Vmbkmcl.sys. Эта функция доступна только для сервера из структуры KMCL_SERVER_ONLY_METHODS.

Дополнительные сведения см. в разделе "Примечания" KMCL_SERVER_ONLY_METHODS.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 10 версии 1803
заголовка	vmbuskernelmodeclientlibapi.h

См. также

VmbChannelSaveBegin

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