FwpsvSwitchEventsSubscribe0 関数 (fwpsk.h)
FwpsvSwitchEventsSubscribe0 関数は、仮想ポートの作成や削除などの仮想スイッチ レイヤー イベントのコールバック エントリ ポイントを登録します。
構文
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 コードのいずれかを返します。
リターン コード | 説明 |
---|---|
|
分類要求へのハンドルが正常に返されました。 classifyHandle パラメーターが指す変数には、分類要求のハンドルが含まれています。 |
|
エラーが発生しました。 |
解説
コールアウト ドライバーは FwpsvSwitchEventsSubscribe0 関数を呼び出して、仮想スイッチ レイヤー イベントのコールバック エントリ ポイントを登録します。
コールバック通知関数のエントリ ポイントは、 および FWPS_VSWITCH_EVENT_DISPATCH_TABLE0 構造体で指定されます。
引き出しドライバーは、後で FwpsvSwitchEventsUnsubscribe0 を呼び出してシステム リソースを解放する必要があります。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 8以降で使用できます。 |
対象プラットフォーム | ユニバーサル |
Header | fwpsk.h (Fwpsk.h を含む) |
Library | Fwpkclnt.lib |
IRQL | <= PASSIVE_LEVEL |