共用方式為


FN_VMB_CHANNEL_INIT_SET_MAXIMUM_EXTERNAL_DATA回呼函式 (vmbuskernelmodeclientlibapi.h)

[某些資訊與發行前的產品有關,在正式發行前可能會大幅修改。 Microsoft未就此處提供的資訊提供任何明示或默示擔保。

VmbChannelInitSetMaximumExternalData 函式會設定封包所描述的數據大小和鏈結長度上限,但不會直接在封包中傳送。 也就是說,ExternalDataMdl 所描述的緩衝區大小上限

語法

FN_VMB_CHANNEL_INIT_SET_MAXIMUM_EXTERNAL_DATA FnVmbChannelInitSetMaximumExternalData;

NTSTATUS FnVmbChannelInitSetMaximumExternalData(
  VMBCHANNEL Channel,
  UINT32 DataSize,
  UINT32 ChainLength
)
{...}

參數

Channel

核心模式客戶端連結庫 (KMCL) 通道的指標。

DataSize

外部數據的大小上限。

ChainLength

傳入 MDL 鏈結中的記憶體描述元清單 (MDLs) 數目上限。

傳回值

VmbChannelInitSetMaximumExternalData 可以傳回下列其中一個狀態值:

傳回碼 描述
STATUS_SUCCESS
函式已順利完成。
STATUS_INVALID_PARAMETER_1
信道 值無效或處於無效狀態,例如 Disabled。
STATUS_INVALID_PARAMETER_2
DataSize 值無效。 零 (0) 無效。
STATUS_INVALID_PARAMETER_3
ChainLength 值無效。 零 (0) 無效。

言論

KMCL 可確保您的通道緩衝區夠大,足以傳送包含指定限制中緩衝區的封包。

重要

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

如需詳細資訊,請參閱 KMCL_CLIENT_INTERFACE_V1的一節。

要求

要求 價值
最低支援的用戶端 Windows 10 版本 1803
標頭 vmbuskernelmodeclientlibapi.h