[某些資訊與發行前的產品有關,在正式發行前可能會大幅修改。 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 可以傳回下列其中一個狀態值:
| 傳回碼 | 描述 |
|---|---|
|
函式已順利完成。 |
|
信道 值無效或處於無效狀態,例如 Disabled。 |
|
DataSize 值無效。 零 (0) 無效。 |
|
ChainLength 值無效。 零 (0) 無效。 |
言論
KMCL 可確保您的通道緩衝區夠大,足以傳送包含指定限制中緩衝區的封包。
重要
此函式是透過 Vmbkmcl.sys 總線驅動程式提供的 VMBus 核心模式用戶端連結庫 (KMCL) 介面來呼叫。 這是從 KMCL_CLIENT_INTERFACE_V1 結構存取的用戶端函式。
如需詳細資訊,請參閱 KMCL_CLIENT_INTERFACE_V1的一節。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows 10 版本 1803 |
| 標頭 | vmbuskernelmodeclientlibapi.h |