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

[アーティクル]
02/06/2025

フィルターエンジンは、vSwitchPolicyEventNotifyFn (FWPS_VSWITCH_POLICY_EVENT_CALLBACK0) 吹き出し関数を呼び出して、仮想スイッチポリシーイベントについてコールアウトドライバーに通知します。

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

構文

FWPS_VSWITCH_POLICY_EVENT_CALLBACK0 FwpsVswitchPolicyEventCallback0;

NTSTATUS FwpsVswitchPolicyEventCallback0(
  [in, optional] void *notifyContext,
  [in]           void *completionContext,
  [in]           FWPS_VSWITCH_EVENT_TYPE eventType,
  [in]           const NDIS_SWITCH_PARAMETERS *vSwitch,
  [in, optional] const NDIS_SWITCH_PORT_PROPERTY_PARAMETERS *vSwitchPortProperty,
  [in, optional] const NDIS_SWITCH_PORT_PROPERTY_DELETE_PARAMETERS *vSwitchPortPropertyDelete
)
{...}

パラメーター

[in, optional] notifyContext

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

[in] completionContext

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

[in] eventType

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

[in] vSwitch

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

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

[in, optional] vSwitchPortProperty

NDIS_SWITCH_PORT_PROPERTY_PARAMETERS 構造体へのポインター。仮想スイッチのポートプロパティ。

[in, optional] vSwitchPortPropertyDelete

NDIS_SWITCH_PORT_PROPERTY_DELETE_PARAMETERS 構造体へのポインター。仮想スイッチのポートプロパティ。

戻り値

吹き出しの

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

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

備考

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

vSwitchPolicyEventNotifyFn コールバックが登録されている場合、移行先ホストのコールアウトには、ライブマイグレーション中および移行中の VM を新しいホストで実行する前に、仮想スイッチポート用に構成されたポリシーに関する通知が送信されます。

ライブマイグレーションを使用しない場合、vm の保存操作 vSwitchPolicyEventNotifyFn も呼び出されます。

VMMS WMI インターフェイスを介して構成されたベンダーフィルターポリシーへの変更は、OID 要求を使用して WFP 仮想スイッチ拡張機能に渡されます。これらの OID は、PropertyType メンバーが NdisSwitchPortPropertyTypeCustom 型に設定された NDIS_SWITCH_PORT_PROPERTY_PARAMETERS 構造体を持ちます。

WFP フィルタードライバーは、仮想スイッチポートのポリシープロパティの追加についてコールアウトドライバーに通知するために、eventType パラメーターにFWPS_VSWITCH_EVENT_POLICY_ADDの種類を設定して vSwitchPolicyEventNotifyFn をする OID_SWITCH_PORT_PROPERTY_ADD OID 要求の情報を渡します。

WFP フィルタードライバーは、仮想スイッチポートポリシーのプロパティの更新について吹き出しフィルタードライバー に通知するために、eventType パラメーターに設定されたFWPS_VSWITCH_EVENT_POLICY_UPDATEの種類を持つ vSwitchPolicyEventNotifyFn に OID_SWITCH_PORT_PROPERTY_UPDATE OID 要求の情報を渡します。

これらの OID には、ポリシーが属する WFP プロバイダーを一意に識別するプロパティ識別子 GUID も含まれます。プロパティ識別子 GUID は、ベンダーが VMMS を使用してそのポリシーを構成するときに提供され、GUID は、ベンダーが WFP にプロバイダーを登録するために使用するのと同じ GUID である必要があります。

WFP は、プロパティ識別子 GUID と、FwpsvSwitchEventsSubscribe0 関数から指定されたプロバイダー GUID との照合を試みます。一致する場合、WFP は対応する vSwitchPolicyEventNotifyFn を呼び出し、NDIS_SWITCH_PORT_PROPERTY_PARAMETERS 構造体を吹き出しに渡します。

WFP フィルタードライバーは、仮想スイッチポートのポリシープロパティの削除について吹き出しフィルタードライバーに通知するために、eventType パラメーターに設定されたFWPS_VSWITCH_EVENT_POLICY_DELETEの種類を使用して vSwitchPolicyEventNotifyFn をする OID_SWITCH_PORT_PROPERTY_DELETE OID 要求の情報を渡します。削除プロパティは、NDIS_SWITCH_PORT_PROPERTY_DELETE_PARAMETERS 構造体で指定されます。

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

必要条件

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

次の方法で共有

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

構文

パラメーター

戻り値

備考

必要条件

関連項目

フィードバック

その他のリソース