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

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

  • Статья

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

Функция VmbChannelInitSetMaximumExternalData задает максимальный размер и длину цепочки данных, которые описываются пакетом, но не отправляются непосредственно в пакете. То есть максимальный размер буфера, описанный в ExternalDataMdl.

Синтаксис

FN_VMB_CHANNEL_INIT_SET_MAXIMUM_EXTERNAL_DATA FnVmbChannelInitSetMaximumExternalData;

NTSTATUS FnVmbChannelInitSetMaximumExternalData(
  VMBCHANNEL Channel,
  UINT32 DataSize,
  UINT32 ChainLength
)
{...}

Параметры

Channel

Указатель на канал клиентской библиотеки режима ядра (KMCL).

DataSize

Максимальный размер внешних данных.

ChainLength

Максимальное количество Списки дескриптора памяти (MDL) во входящем MDL-цепочке.

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

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

Код возврата Описание
STATUS_SUCCESS
 Функция успешно завершена.
STATUS_INVALID_PARAMETER_1
 Значение канала было недопустимым или в недопустимом состоянии, например Отключено.
STATUS_INVALID_PARAMETER_2
 Недопустимое значение DataSize . Нуль (0) недопустим.
STATUS_INVALID_PARAMETER_3
 Недопустимое значение ChainLength . Нуль (0) недопустим.

Комментарии

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

Важно!

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

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

Требования

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