функция обратного вызова 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