EVT_VMB_CHANNEL_RESTORE_PACKET コールバック関数 (vmbuskernelmodeclientlibapi.h)

[アーティクル]
02/26/2024

[一部の情報はリリース前の製品に関することであり、正式版がリリースされるまでに大幅に変更される可能性があります。ここに記載された情報について、Microsoft は明示または黙示を問わずいかなる保証をするものでもありません。]

EvtVmbChannelRestorePacket コールバック関数は、仮想化サービスプロバイダー (VSP) サーバーエンドポイントがパケットオブジェクトに関連付けられている状態を復元する必要がある場合に呼び出されます。

構文

EVT_VMB_CHANNEL_RESTORE_PACKET EvtVmbChannelRestorePacket;

NTSTATUS EvtVmbChannelRestorePacket(
  [in] VMBCHANNEL Channel,
  [in] PVOID LibBuf,
  [in] UINT32 LibBufSize,
  [in] PVOID SaveBuf,
  [in] UINT32 SaveBufSize
)
{...}

パラメーター

[in] Channel

パケットが到着するチャネル。

[in] LibBuf

カーネルモードクライアントライブラリ (KMCL) 内部のパケットオブジェクトの状態へのポインター。

[in] LibBufSize

LibBuf パラメーターのサイズ (バイト単位)。

[in] SaveBuf

VSP に固有のトランザクション状態へのポインター。

[in] SaveBufSize

SaveBuf パラメーターのサイズ (バイト単位)。

戻り値

EvtVmbChannelRestorePacket は状態コードを返します。

注釈

VmbServerChannelInitSetSaveRestorePacketCallbacks 関数は、各チャネルのパケットを復元するためのコールバック関数を設定します。

フライト中のパケットオブジェクトを復元するには、VSP は VmbPacketAllocate 関数を使用して新しいパケットを割り当てる必要があります。 VSP は、LibBuf と LibBufSize を VmbPacketRestore 関数に渡すことによって、パケットを以前の状態に復元します。 VSP が EvtVmbChannelSavePacket コールバック関数でトランザクションの内部状態を指定した場合、これは SaveBuf で提供され、VSP によって復元されます。