FwpsAllocateCloneNetBufferList0 関数 (fwpsk.h)

[アーティクル]
08/07/2023

FwpsAllocateCloneNetBufferList0 関数は、既存のNET_BUFFER_LIST構造体の複製であるNET_BUFFER_LIST構造体を割り当てます。

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

構文

NTSTATUS FwpsAllocateCloneNetBufferList0(
  [in, out]      NET_BUFFER_LIST *originalNetBufferList,
  [in, optional] NDIS_HANDLE     netBufferListPoolHandle,
  [in, optional] NDIS_HANDLE     netBufferPoolHandle,
  [in]           ULONG           allocateCloneFlags,
  [out]          NET_BUFFER_LIST **netBufferList
);

パラメーター

[in, out] originalNetBufferList

複製される元の NET_BUFFER_LIST 構造体へのポインター。

[in, optional] netBufferListPoolHandle

への以前の呼び出しから取得されたNET_BUFFER_LIST プールハンドル NdisAllocateNetBufferListPool 関数。このパラメーターは省略可能であり、 NULL にすることができます。

[in, optional] netBufferPoolHandle

NdisAllocateNetBufferPool 関数の以前の呼び出しから取得されたNET_BUFFER プールハンドル。このパラメーターは省略可能であり、 NULL にすることができます。

[in] allocateCloneFlags

現在、この関数に対して定義されているフラグはありません。コールアウトドライバーでは、このパラメーターを 0 に設定する必要があります。

[out] netBufferList

複製 NET_BUFFER_LIST 構造体へのポインターを受け取る変数へのポインター。

戻り値

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

リターンコード	説明
STATUS_SUCCESS	複製 NET_BUFFER_LIST 構造体が正常に割り当てられました。
その他の状態コード	エラーが発生しました。

解説

コールアウトドライバーは 、FwpsAllocateCloneNetBufferList0 関数を呼び出して、既存のNET_BUFFER_LIST 構造体の複製NET_BUFFER_LIST構造体を割り当てます。

この関数は、のラッパーです。 NdisAllocateCloneNetBufferList 関数ですが、WFP パケットインジェクション関数で使用するために特殊化されています。

複製NET_BUFFER_LIST構造体に特定のプールに関連付けられている属性が必要な場合、引き出しドライバーは 、NetBufferListPoolHandle または NetBufferPoolHandle パラメーターでプールハンドルを指定する必要があります。これらのパラメーターが NULL の場合は、NDIS によって事前に割り当てられた既定のプールが使用されます。

複製NET_BUFFER_LIST構造体は、元のNET_BUFFER_LIST構造で記述されたものと同じデータを記述します。 FwpsAllocateCloneNetBufferList0 関数は、元の MDL で記述されたデータを新しいデータバッファーにコピーしません。代わりに、複製NET_BUFFER_LIST構造体は元のデータバッファーを参照します。複製NET_BUFFER_LIST構造に初期 NET_BUFFER_LIST_CONTEXT 構造体。

この関数は、新しく作成された複製NET_BUFFER_LIST構造体の ParentNetBufferList メンバーを、親NET_BUFFER_LIST構造体を指すよう設定します。親構造体の ChildRefCount メンバーは 1 ずつインクリメントされます。

コールアウトドライバーは、複製NET_BUFFER_LIST構造体を変更し、パケットインジェクション関数を呼び出すことによって、元のNET_BUFFER_LIST構造の代わりにネットワークスタックに挿入できます。複製NET_BUFFER_LIST構造体によって記述されたデータがネットワークスタックに正常に挿入された後、引き出し線ドライバーは FwpsFreeCloneNetBufferList0 関数を呼び出すことによって、複製NET_BUFFER_LIST構造体を解放します。

コールアウトドライバーは、複製されたネットバッファーリスト内の個々のネットバッファー (NET_BUFFER) または MDL を挿入または置換できます。このようなドライバーは、を呼び出す前に変更を元に戻す必要もあります。 FwpsFreeCloneNetBufferList0 関数。

複製されたパケットの管理に関するガイドライン

コールアウトドライバーは、複製されたパケットを無期限に保持することはできません。複製されたパケットは、アイドル状態のコンピューターでの電源管理操作に干渉する可能性があります。

WFP で複製されたパケットを使用する目的は、ユーザーモードアプリケーションまたはその他の比較的高速な操作から明確にすることです。コールアウトドライバーは、ユーザー入力の待機中、Web サービスのクリアランスの待機中、または任意の時間がかかる可能性があるその他の操作を待機している間、複製されたパケットを保持してはなりません。

コールアウトドライバーは、長い可能性のある操作を待機する必要がある場合は、を使用してパケットのディープコピーを作成します。 FwpsAllocateNetBufferAndNetBufferList0 は、元のパケットをブロックして吸収します。

コールアウトドライバーは、常にできるだけ早く保持されたパケットを返す必要があります。

要件

要件	値
サポートされている最小のクライアント	Windows Vista 以降で使用できます。
対象プラットフォーム	ユニバーサル
Header	fwpsk.h (Fwpsk.h を含む)
Library	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL