共用方式為

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 會傳回下列值：

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

言論

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

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

重要

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

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

要求

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

另請參閱

VmbChannelSaveBegin