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

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