共用方式為

FN_VMB_SERVER_CHANNEL_INIT_SET_MMIO_MEGABYTES回呼函式 (vmbuskernelmodeclientlibapi.h)

  • 發行項

VmbServerChannelInitSetMmioMegabytes 函式會指定要為裝置保留的客體內存對應 I/O 數量、MB (MMIO) 空間。

語法

FN_VMB_SERVER_CHANNEL_INIT_SET_MMIO_MEGABYTES FnVmbServerChannelInitSetMmioMegabytes;

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

參數

Channel

通道的句柄。

MmioMegabytes

要保留的 MMIO 空間數量，以 MB 為單位。

MmioMegabytesOptional

要保留的額外選擇性MMIO空間數量，以MB為單位。

傳回值

VmbServerChannelInitSetMmioMegabytes 會傳回下列狀態值：

傳回碼 Description
STATUS_INVALID_PARAMETER_1
 通道值無效或處於無效狀態，例如 Disabled。
STATUS_INVALID_PARAMETER
 MmioMegabytes 和 MmioMegabytesOptional 的值都是零 (0) 。 其中一個參數必須大於零

備註

此函式是驅動程式建立者的便利性。 與客體即插即用管理員互動，並直接要求記憶體對應 I/O 空間，即可完成它所做的一切。 Windows 和 Linux VMBus 驅動程式具有代表用戶端保留 MMIO 空間的容量是常見的需求。 此函式可讓伺服器端點建議保留正確的MMIO空間量。

重要

此函式是透過 VMBus 核心模式用戶端連結庫 (KMCL) 介面呼叫，由 Vmbkmcl.sys 總線驅動程式提供。 這是從 KMCL_SERVER_ONLY_METHODS 結構存取的僅限伺服器函式。

如需詳細資訊，請參閱 KMCL_SERVER_ONLY_METHODS的一節。

規格需求

需求 值
最低支援的用戶端 Windows 10 版本 1809
標頭 vmbuskernelmodeclientlibapi.h