FwpsNetBufferListAssociateContext1 関数 (fwpsk.h)
FwpsNetBufferListAssociateContext1 関数は、吹き出しドライバーのコンテキストをネットワーク バッファー リストに関連付け、ネットワーク バッファー リスト イベントの通知を構成します。
構文
NTSTATUS FwpsNetBufferListAssociateContext1(
[in, out] NET_BUFFER_LIST *netBufferList,
[in] UINT16 layerId,
[in] UINT64 context,
[in] UINT64 contextTag,
GUID *providerGuid,
[in, out] void *deviceObject,
[in] FWPS_NET_BUFFER_LIST_NOTIFY_FN1 notifyFn,
[in] UINT32 flags
);
パラメーター
[in, out] netBufferList
吹き出しドライバーに関心のある 1 つ以上のパケットを示すネットワーク バッファーの一覧。
[in] layerId
コンテキストが関連付けられているレイヤーの識別子。 NDIS 受信パスからこの関数を呼び出すときは、このパラメーターを FWPS_LAYER_NON_WFPに設定します。
[in] context
吹き出しドライバーによって設定された任意のコンテキスト情報。 フィルター エンジンは、このコンテキストをコールアウト ドライバーに渡します。
FWPS_NET_BUFFER_LIST_NOTIFY_FN1 関数。
[in] contextTag
を呼び出して取得したローカル一意識別子FwpsNetBufferListGetTagForContext0 関数を します。
providerGuid
プロバイダー GUID。
[in, out] deviceObject
引き出しドライバーのデバイス オブジェクトへのポインター。
[in] notifyFn
引き出しドライバーの FWPS_NET_BUFFER_LIST_NOTIFY_FN1 関数へのポインター。 フィルター エンジンは、この関数に状態通知を送信します。
[in] flags
このパラメーターは将来使用するために予約されており、0 に設定されます。
戻り値
FwpsNetBufferListAssociateContext1 関数は、次のいずれかの NTSTATUS コードを返します。
リターン コード | 形容 |
---|---|
|
関連付けが成功しました。 |
|
エラーが発生しました。 |
備考
FwpsNetBufferListAssociateContext1 関数は、パケットのグループをコールアウト ドライバーに関連付けます。 関心のあるパケットは、スタック内の複数のレイヤーを介して検査するために追跡できます。
この関数を呼び出す前に、FwpsNetBufferListGetTagForContext0 関数を呼び出してコンテキスト タグを取得する必要があります。
この関数は、基本的に以前のバージョンと同じです。
FwpsNetBufferListAssociateContext0 をします。 唯一の違いは、notifyFn パラメーターが指す更新された FWPS_NET_BUFFER_LIST_NOTIFY_FN1 関数です。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Windows 8 以降で使用できます。 |
ターゲット プラットフォーム の | 万国 |
ヘッダー | fwpsk.h (Fwpsk.h を含む) |
ライブラリ | Fwpkclnt.lib |
IRQL | <= DISPATCH_LEVEL |
関連項目
FWPS_NET_BUFFER_LIST_NOTIFY_FN1
FwpsNetBufferListAssociateContext0
FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRemoveContext0 FwpsNetBufferListRetrieveContext0パケット タグ付け を使用した