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

  • Статья

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

Функция 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