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

Статья
08/08/2023

Функция VmbServerChannelInitSetSaveRestorePacketCallbacks задает функции обратного вызова сохранения и восстановления, которые вызываются для каждого пакета, когда драйвер вызывает функцию сохранения, например VmbChannelSaveBegin, VmbChannelSaveContinue и VmbChannelSaveEnd или функцию VmbChannelRestoreFromBuffer .

Синтаксис

FN_VMB_SERVER_CHANNEL_INIT_SET_SAVE_RESTORE_PACKET_CALLBACKS FnVmbServerChannelInitSetSaveRestorePacketCallbacks;

NTSTATUS FnVmbServerChannelInitSetSaveRestorePacketCallbacks(
  VMBCHANNEL Channel,
  PFN_VMB_CHANNEL_SAVE_PACKET SavePacketCallback,
  PFN_VMB_CHANNEL_RESTORE_PACKET RestorePacketCallback
)
{...}

Параметры

Channel

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

SavePacketCallback

Функция обратного вызова, вызываемая во время сохранения канала.

RestorePacketCallback

Функция обратного вызова, вызываемая во время восстановления канала.

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

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

Код возврата	Описание
STATUS_INVALID_PARAMETER_1	Значение канала было недопустимым или находилось в недопустимом состоянии, например Отключено.

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

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