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

  • Статья

Функция VmbServerChannelInitSetMmioMegabytes указывает объем пространства ввода-вывода, сопоставленного с гостевой памятью (MMIO), в мегабайтах, который необходимо зарезервировать для устройства.

Синтаксис

FN_VMB_SERVER_CHANNEL_INIT_SET_MMIO_MEGABYTES FnVmbServerChannelInitSetMmioMegabytes;

NTSTATUS FnVmbServerChannelInitSetMmioMegabytes(
  VMBCHANNEL Channel,
  UINT16 MmioMegabytes,
  UINT16 MmioMegabytesOptional
)
{...}

Параметры

Channel

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

MmioMegabytes

Объем зарезервированного пространства MMIO в мегабайтах.

MmioMegabytesOptional

Объем дополнительного дополнительного пространства MMIO в мегабайтах для резервирования.

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

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

Код возврата Описание
STATUS_INVALID_PARAMETER_1
 Значение канала было недопустимым или в недопустимом состоянии, например Отключено.
STATUS_INVALID_PARAMETER
 Значения MmioMegabytes и MmioMegabytesOptional равны нулю (0). Один из этих параметров должен быть больше нуля

Комментарии

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

Важно!

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

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

Требования

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