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以降で使用できます。
対象プラットフォーム ユニバーサル
Header fwpsk.h (Fwpsk.h を含む)
Library Fwpkclnt.lib
IRQL <= PASSIVE_LEVEL

こちらもご覧ください

FWPS_VSWITCH_EVENT_DISPATCH_TABLE0

FwpsvSwitchEventsUnsubscribe0