通过

FN_VMB_SERVER_CHANNEL_INIT_SET_MMIO_MEGABYTES回调函数 （vmbuskernelmodeclientlibapi.h）

  • 项目

VmbServerChannelInitSetMmioMegabytes 函数指定要为设备保留的来宾内存映射 I/O （MMIO） 空间量（MB）。

语法

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）。 其中一个参数必须大于零

言论

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

重要

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

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

要求

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