次の方法で共有


FWPS_VSWITCH_RUNTIME_STATE_SAVE_CALLBACK0 コールバック関数 (fwpsk.h)

フィルター エンジンは 、vSwitchRuntimeStateSaveNotifyFn (FWPS_VSWITCH_RUNTIME_STATE_SAVE_CALLBACK0) 吹き出し関数を呼び出して、仮想スイッチの実行時状態の保存イベントについてコールアウト ドライバーに通知します。

注意

FWPS_VSWITCH_RUNTIME_STATE_SAVE_CALLBACK0 は、特定のバージョンの FWPS_VSWITCH_RUNTIME_STATE_SAVE_CALLBACKです。 詳細については、「 WFP Version-Independent 名と特定のバージョンの Windows を対象 とする」を参照してください。

構文

FWPS_VSWITCH_RUNTIME_STATE_SAVE_CALLBACK0 FwpsVswitchRuntimeStateSaveCallback0;

NTSTATUS FwpsVswitchRuntimeStateSaveCallback0(
  [in, optional] void *notifyContext,
  [in]           void *completionContext,
  [in]           FWPS_VSWITCH_EVENT_TYPE eventType,
  [in]           const NDIS_SWITCH_PARAMETERS *vSwitch,
  [in]           NDIS_SWITCH_PORT_ID portId,
                 void **runtimeState,
  [out]          SIZE_T *runtimeStateLength
)
{...}

パラメーター

[in, optional] notifyContext

コールアウト ドライバーによって提供されるコンテキストへのポインター。 ドライバーは、FwpsvSwitchEventsSubscribe0 関数の notifyContext パラメーターにこのポインターを渡しました。 このパラメーターは省略可能であり、NULL にすることができます。

[in] completionContext

コールアウト ドライバーによって提供される完了コンテキストへのポインター。 このパラメーターは省略可能であり、NULL にすることができます。

[in] eventType

FWPS_VSWITCH_EVENT_TYPE列挙値の 1 つとして指定された仮想スイッチ イベントの種類。 詳細については、「解説」を参照してください。

[in] vSwitch

仮想スイッチに関する情報を含む NDIS_SWITCH_PARAMETERS 構造体へのポインター。

注意

NDIS_SWITCH_PARAMETERS構造体の情報は、仮想スイッチの初期状態を反映し、必ずしも現在の状態であるとは限りません。 特に、仮想スイッチ PnP イベントがトリガーされていない限り、 NumSwitchPorts メンバーと IsActive メンバーの初期値は 0 のままになることがあります。 現在の状態情報は、このコールバック関数の他のパラメーターにあります。

[in] portId

ソース スイッチ ポート識別子。

runtimeState

実行時状態出力結果バッファーの場所。

[out] runtimeStateLength

実行時状態バッファー内の実行時状態情報の長さ (バイト単位)。

戻り値

吹き出しの FWPS_VSWITCH_RUNTIME_STATE_SAVE_CALLBACK0 関数は、次のいずれかの NTSTATUS コードを返します。

リターン コード 説明
STATUS_SUCCESS 吹き出しドライバーは、フィルター エンジンからの通知を受け入れます。
STATUS_PENDING 操作は保留中であり、後で完了します。 コールアウト ドライバーは FwpsvSwitchNotifyComplete0 関数を呼び出して、保留中の操作を完了します。
その他の状態コード エラーが発生しました。

解説

コールアウト ドライバーは、FwpsvSwitchEventsSubscribe0 関数を呼び出すことによって、vSwitchRuntimeStateSaveNotifyFn 関数を登録します。

vSwitchRuntimeStateSaveNotifyFn コールバックが登録されている場合、ライブ マイグレーションまたはローカルの保存および復元操作中にソース VM のランタイム状態を取得し、ターゲット VM の実行時状態を復元するようにコールアウトが通知されます。 保存の場合、vSwitchRuntimeStateSaveNotifyFneventType パラメーターはFWPS_VSWITCH_EVENT_RUNTIME_STATE_SAVEに設定されます。

仮想スイッチ拡張プロトコル ドライバーは、操作中に OID_SWITCH_NIC_SAVE のオブジェクト識別子 (OID) メソッド要求を発行して、仮想スイッチ ポートの実行時データを保存します。 フィルター ドライバーは、仮想スイッチ ポートの実行時データを後で保存および復元できるように、このデータを返します。

すべてのコールアウトからランタイム データ BLOB が収集されると、WFP は NDIS_SWITCH_NIC_SAVE_STATE 構造に収集されたデータを入力し、保存状態要求を完了します。

吹き出しは 、vSwitchRuntimeStateSaveNotifyFn からSTATUS_PENDINGを返すことができます。 この場合、WFP は FilterOidRequest ハンドラーでSTATUS_PENDINGを返し、後で完了します。 コールアウト ドライバーは FwpsvSwitchNotifyComplete0 関数を呼び出して、保留中の操作を完了します。

ランタイム状態の復元については、 vSwitchRuntimeStateRestoreNotifyFn (FWPS_VSWITCH_RUNTIME_STATE_RESTORE_CALLBACK0) 関数を参照してください。

要件

要件
サポートされている最小のクライアント Windows 8 以降で使用できます。
対象プラットフォーム Windows
ヘッダー fwpsk.h (Fwpsk.h を含む)
IRQL <= DISPATCH_LEVEL

こちらもご覧ください

引き出し線ドライバーの吹き出し関数

FWPS_VSWITCH_EVENT_TYPE

FWPS_VSWITCH_RUNTIME_STATE_RESTORE_CALLBACK0

FilterOidRequest

FwpsvSwitchEventsSubscribe0

FwpsvSwitchNotifyComplete0

NDIS_SWITCH_NIC_SAVE_STATE

NDIS_SWITCH_PARAMETERS

OID_SWITCH_NIC_SAVE