Share via

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
Header vmbuskernelmodeclientlibapi.h

こちらもご覧ください

VmbChannelSaveBegin