共用方式為


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 空間數量,以 MB 為單位。

MmioMegabytesOptional

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

傳回值

VmbServerChannelInitSetMmioMegabytes 會傳回下列狀態值:

傳回碼 描述
STATUS_INVALID_PARAMETER_1
信道 值無效或處於無效狀態,例如 Disabled。
STATUS_INVALID_PARAMETER
mmioMegabytesmmioMegabytesOptional 的值為零 (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