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

Статья
02/07/2025

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

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

Синтаксис

FN_VMB_CHANNEL_INIT_SET_MAXIMUM_EXTERNAL_DATA FnVmbChannelInitSetMaximumExternalData;

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

Параметры

Channel

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

DataSize

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

ChainLength

Максимальное количество списков дескрипторов памяти (MDLs) в входящей цепочке 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

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