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 會傳回下列狀態值:
| 傳回碼 | 描述 |
|---|---|
|
信道 值無效或處於無效狀態,例如 Disabled。 |
|
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 |