次の方法で共有

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