次の方法で共有

FwpsAllocateNetBufferAndNetBufferList0 関数 (fwpsk.h)

  • [アーティクル]

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

こちらもご覧ください

FwpsFreeNetBufferList0

NET_BUFFER_LIST

NET_BUFFER_LIST_CONTEXT

NdisAllocateNetBufferAndNetBufferList NdisAllocateNetBufferListPool

パケット挿入関数