次の方法で共有

FwpsvSwitchEventsSubscribe0 関数 (fwpsk.h)

  • [アーティクル]

FwpsvSwitchEventsSubscribe0 関数は、仮想ポートの作成や削除などの仮想スイッチ レイヤー イベントのコールバック エントリ ポイントを登録します。

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

 

構文

NTSTATUS FwpsvSwitchEventsSubscribe0(
  const GUID                              *providerGuid,
  void                                    *notifyContext,
  UINT32                                  flags,
  void                                    *reserved,
  const FWPS_VSWITCH_EVENT_DISPATCH_TABLE *eventDispatchTable,
  UINT32                                  *subscriptionId
);

パラメーター

providerGuid

プロバイダー GUID。

notifyContext

引き出しドライバーが提供するコンテキストへのオプションのポインター。 イベント通知関数は、このパラメーターをドライバーに渡します。

flags

引っ込み思案。 0 に設定します。

reserved

引っ込み思案。 0 に設定します。

eventDispatchTable

仮想スイッチ レイヤー イベントのコールバック エントリ ポイントを定義する FWPS_VSWITCH_EVENT_DISPATCH_TABLE 構造体へのポインター。

subscriptionId

WFP がサブスクリプションに割り当てる一意の識別子を含む変数へのポインター。 呼び出し元は、FwpsvSwitchEventsUnsubscribe0 関数を使用して WFP にサブスクリプション識別子を返す必要があります。

戻り値

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

リターン コード 形容
STATUS_SUCCESS
 分類要求のハンドルが正常に返されました。 classifyHandle パラメーターが指す変数には、分類要求のハンドルが含まれます。
その他の状態コードの
 エラーが発生しました。

備考

コールアウト ドライバーは、FwpsvSwitchEventsSubscribe0 関数を呼び出して、仮想スイッチ レイヤー イベントのコールバック エントリ ポイントを登録します。

コールバック通知関数のエントリ ポイントは、構造体で指定 FWPS_VSWITCH_EVENT_DISPATCH_TABLE0。

引き出しドライバーは、システム リソース 解放するために、後で FwpsvSwitchEventsUnsubscribe0 を呼び出す必要があります。

必要条件

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

関連項目

FWPS_VSWITCH_EVENT_DISPATCH_TABLE0

FwpsvSwitchEventsUnsubscribe0