共用方式為

FN_VMB_CHANNEL_SAVE_CONTINUE回呼函式 (vmbuskernelmodeclientlibapi.h)

  • 發行項

[某些資訊與發行前發行的產品有關，在正式發行前可能會大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。]

VmbChannelSaveContinue 函式會將通道狀態儲存至緩衝區。 執行此函式之前，請先執行 VmbChannelSaveBegin 。 驅動程式必須檢查函式的傳回值。

語法

FN_VMB_CHANNEL_SAVE_CONTINUE FnVmbChannelSaveContinue;

NTSTATUS FnVmbChannelSaveContinue(
  VMBCHANNEL Channel,
  PVOID SaveBuffer,
  ULONG SaveBufferSize,
  PULONG BytesFilled,
  PULONG BytesRequired
)
{...}

參數

Channel

要儲存之通道的句柄。

SaveBuffer

要儲存狀態信息的緩衝區指標。

SaveBufferSize

儲存緩衝區的大小，以位元組為單位。

BytesFilled

變數的指標，接收複製到儲存緩衝區的位元元組數目。

BytesRequired

變數的指標，接收此函式在下一個呼叫上進行進度所需的位元元組數目。

傳回值

VmbChannelSaveContinue 會傳回下列值：

傳回碼 Description
STATUS_SUCCESS
 已儲存狀態。
STATUS_BUFFER_TOO_SMALL
儲存緩衝區太小。 BytesNeeded 參數包含進行任何進度所需的位元元組數目。
STATUS_STATUS_BUFFER_OVERFLOW
 某些數據已寫入儲存緩衝區，但有更多數據要儲存。

備註

儲存程式會將數據儲存在「區塊」中，而且可以從停止的點繼續。

如果呼叫端事先未配置足夠的空間，可能需要多個呼叫。

重要

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

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

規格需求

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

另請參閱

VmbChannelSaveBegin