FwpsAllocateNetBufferAndNetBufferList0 関数 (fwpsk.h)

[アーティクル]
03/05/2024

FwpsAllocateNetBufferAndNetBufferList0 関数は、新しいNET_BUFFER_LIST構造体を割り当てます。

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

構文

NTSTATUS FwpsAllocateNetBufferAndNetBufferList0(
  [in]           NDIS_HANDLE     poolHandle,
  [in]           USHORT          contextSize,
  [in]           USHORT          contextBackFill,
  [in, optional] MDL             *mdlChain,
  [in]           ULONG           dataOffset,
  [in]           SIZE_T          dataLength,
  [out]          NET_BUFFER_LIST **netBufferList
);

パラメーター

[in] poolHandle

NdisAllocateNetBufferListPool 関数の以前の呼び出しから取得されたNET_BUFFER_LIST プールハンドル。

[in] contextSize

引き出しドライバー用に予約する NET_BUFFER_LIST_CONTEXT 構造体で使用されるデータ空間のサイズ (バイト単位)。このパラメーターの値は、 MEMORY_ALLOCATION_ALIGNMENTによって定義された値の倍数である必要があります。

[in] contextBackFill

引き出しドライバーに必要な未使用のデータ領域 (バックフィル領域) のサイズ (バイト単位)。 FwpsAllocateNetBufferAndNetBufferList0 関数は、ContextSize パラメーターで指定された値にこの値を追加し、追加の領域を割り当てます。このパラメーターの値は、 MEMORY_ALLOCATION_ALIGNMENTによって定義された値の倍数である必要があります。

[in, optional] mdlChain

事前割り当て済みのNET_BUFFER構造体を初期化するために使用される MDL チェーンへのポインター。このパラメーターは省略可能であり、 NULL にすることができます。

[in] dataOffset

バッファーの先頭から MDL チェーン内の使用されるデータ空間の先頭までの初期オフセット (バイト単位)。このオフセットの前のデータ領域は未使用のデータ空間です。したがって、この値は、MDL チェーン内の使用可能なバックフィル領域の初期量も表します。

[in] dataLength

MDL チェーンで使用されるデータ空間の長さ (バイト単位)。

[out] netBufferList

新しい NET_BUFFER_LIST 構造体へのポインターを受け取る変数へのポインター。

戻り値

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

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

解説

コールアウトドライバーは 、FwpsAllocateNetBufferAndNetBufferList0 関数を呼び出して、新しい NET_BUFFER_LIST 構造体を割り当てます。

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

新しい NET_BUFFER_LIST 構造体によって記述されたデータがネットワークスタックに正常に挿入されると、コールアウトドライバーは、を呼び出して新しい NET_BUFFER_LIST 構造体を解放します。 FwpsFreeNetBufferList0 関数。

要件

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