共用方式為

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 鏈結中) 記憶體描述元的最大數目 清單 (MDL。

傳回值

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

傳回碼 Description
STATUS_SUCCESS
 函式成功完成。
STATUS_INVALID_PARAMETER_1
 Channel 值無效或處於無效狀態，例如 Disabled。
STATUS_INVALID_PARAMETER_2
 DataSize 值無效。 零 (0) 無效。
STATUS_INVALID_PARAMETER_3
 ChainLength 值無效。 零 (0) 無效。

備註

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

重要

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

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

規格需求

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