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

フィルター エンジンは 、vSwitchInterfaceEventNotifyFn (FWPS_VSWITCH_INTERFACE_EVENT_CALLBACK0) 吹き出し関数を呼び出して、仮想スイッチ インターフェイスに関連付けられているイベントについて吹き出しドライバーに通知します。

構文

FWPS_VSWITCH_INTERFACE_EVENT_CALLBACK0 FwpsVswitchInterfaceEventCallback0;

NTSTATUS FwpsVswitchInterfaceEventCallback0(
  [in, optional] void *notifyContext,
  [in]           void *completionContext,
  [in]           FWPS_VSWITCH_EVENT_TYPE eventType,
  [in]           const NDIS_SWITCH_PARAMETERS *vSwitch,
  [in]           const NDIS_SWITCH_NIC_PARAMETERS *vSwitchNic
)
{...}

パラメーター

[in, optional] notifyContext

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

[in] completionContext

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

[in] eventType

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

[in] vSwitch

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

[in] vSwitchNic

仮想スイッチ ポートに接続されている仮想ミニポート アダプターのパラメーターを指定する NDIS_SWITCH_NIC_PARAMETERS構造体への ポインター。

戻り値

吹き出しの

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

解説

引き出しドライバーは、 を登録します。
vSwitchInterfaceEventNotifyFn 関数を呼び出す
FwpsvSwitchEventsSubscribe0 関数。

eventType パラメーターが WPS_VSWITCH_EVENT_INTERFACE_CREATE に設定されている場合、仮想スイッチ ポートとネットワーク アダプター間の新しいネットワーク接続が完全に確立されます。 vSwitchNic パラメーターは、仮想スイッチ ポートに接続されている仮想ネットワーク アダプターに関する情報を含むNDIS_SWITCH_NIC_PARAMETERS構造体を識別します。

eventType パラメーターがFWPS_VSWITCH_EVENT_INTERFACE_DISCONNECT場合、仮想スイッチ ポートとネットワーク アダプターの間の接続が切断されます。 接続が完全に切断されると、WFP フィルター ドライバーは eventType パラメーターに FWPS_VSWITCH_EVENT_INTERFACE_DELETE設定された vSwitchInterfaceEventNotifyFn を呼び出します。

要件

こちらもご覧ください

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

FWPS_VSWITCH_EVENT_TYPE

FwpsvSwitchEventsSubscribe0

NDIS_SWITCH_NIC_PARAMETERS

NDIS_SWITCH_PARAMETERS