通过

FN_VMB_SERVER_CHANNEL_INIT_SET_MMIO_MEGABYTES回调函数 (vmbuskernelmodeclientlibapi.h)

  • 项目

VmbServerChannelInitSetMmioMegabytes 函数指定为设备保留的来宾内存映射 I/O (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
 通道值无效或处于无效状态，例如 Disabled。
STATUS_INVALID_PARAMETER
 MmioMegabytes 和 MmioMegabytesOptional 的值为 0 (0) 。 其中一个参数必须大于零

注解

此函数的存在是为了方便驱动程序创建者。 它所做的一切操作都可以通过与来宾即插即用管理器交互并直接请求内存映射的 I/O 空间来完成。 Windows 和 Linux VMBus 驱动程序具有代表客户端保留 MMIO 空间的容量，这是一项常见要求。 此函数允许服务器终结点建议要保留的适当 MMIO 空间量。

重要

此函数通过 VMBus 内核模式客户端库 (Vmbkmcl.sys 总线驱动程序提供的 KMCL) 接口调用。 这是从 KMCL_SERVER_ONLY_METHODS 结构访问的仅限服务器的函数。

有关详细信息，请参阅 KMCL_SERVER_ONLY_METHODS 的“备注”部分。

要求

要求 值
最低受支持的客户端 Windows 10 版本 1809
标头 vmbuskernelmodeclientlibapi.h