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

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

  • Статья

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

Функция VmbChannelRestoreFromBuffer восстанавливает состояние клиента из ранее сохраненного состояния. Драйвер должен проверка возвращаемое значение функции.

Синтаксис

FN_VMB_CHANNEL_RESTORE_FROM_BUFFER FnVmbChannelRestoreFromBuffer;

NTSTATUS FnVmbChannelRestoreFromBuffer(
  VMBCHANNEL Channel,
  PVOID Buffer,
  ULONG BufferSize
)
{...}

Параметры

Channel

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

Buffer

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

BufferSize

Размер (в байтах) буфера.

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

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

Код возврата Описание
STATUS_SUCCESS
 Функция успешно завершена.
STATUS_MORE_PROCESSING_REQUIRED
 Состояние было восстановлено успешно, но было сохранено больше блоков.
Другой код состояния, для которого NT_SUCCESS имеет значение FALSE
 Сбой функции.

Комментарии

Ожидается, что вызывающий объект вызовет эту функцию с буферами, содержащими целые "блоки" хранимых данных.

Важно!

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

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

Требования

Требование Значение
Минимальная версия клиента Windows 10 версии 1803
Верхняя часть vmbuskernelmodeclientlibapi.h