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

Статья
08/08/2023

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

Функция VmbPacketSend отправляет данные в буфер пакетов или список внешних дескрипторов памяти (MDL). Функция связывает эти данные с объектом пакета VMBus, который представляет пакет на протяжении всего времени существования транзакции.

Синтаксис

FN_VMB_PACKET_SEND FnVmbPacketSend;

NTSTATUS FnVmbPacketSend(
  __drv_aliasesMem VMBPACKET PacketObject,
  PVOID Buffer,
  UINT32 BufferLength,
  PMDL ExternalDataMdl,
  UINT32 Flags
)
{...}

Параметры

PacketObject

Дескриптор для объекта пакета VMBus.

Buffer

Буфер, содержащий пакет команд, отправляемый через кольцевой буфер VMBus.

BufferLength

Длина буфера в байтах в параметре Buffer .

ExternalDataMdl

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

Flags

Флаги. Ниже приведены соответствующие флаги.

Значение	Значение
VMBUS_CHANNEL_FORMAT_FLAG_WAIT_FOR_COMPLETION	Этот пакет нельзя считать завершенным, и его ресурсы не могут быть освобождены до тех пор, пока пакет завершения не вернется из противоположной конечной точки.
VMBUS_CHANNEL_FORMAT_FLAG_PAGED_BUFFER	Встроенный буфер помещается на страницы и должен обрабатываться соответствующим образом. Это означает, что его необходимо скопировать перед переходом на уровень DPC. За проверку буферов пользовательского режима или обработку нарушений доступа отвечает вызывающий объект.

Значение

VMBUS_CHANNEL_FORMAT_FLAG_WAIT_FOR_COMPLETION

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

VMBUS_CHANNEL_FORMAT_FLAG_PAGED_BUFFER

Встроенный буфер помещается на страницы и должен обрабатываться соответствующим образом. Это означает, что его необходимо скопировать перед переходом на уровень DPC. За проверку буферов пользовательского режима или обработку нарушений доступа отвечает вызывающий объект.

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

Возвращает STATUS_SUCCESS, если операция выполнена успешно, или соответствующий код ошибки NTSTATUS в противном случае.

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

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