FwpsCloneStreamData0 関数 (fwpsk.h)

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

FwpsCloneStreamData0 関数は、既存のFWPS_STREAM_DATA0 データストリームの複製を割り当てます。

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

構文

NTSTATUS FwpsCloneStreamData0(
  [in, out]      FWPS_STREAM_DATA0 *calloutStreamData,
  [in, optional] NDIS_HANDLE       netBufferListPoolHandle,
  [in, optional] NDIS_HANDLE       netBufferPoolHandle,
  [in]           ULONG             allocateCloneFlags,
  [out]          NET_BUFFER_LIST   **netBufferListChain
);

パラメーター

[in, out] calloutStreamData

NET_BUFFER_LIST構造体を複製する元のFWPS_STREAM_DATA0構造体へのポインター。

[in, optional] netBufferListPoolHandle

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

[in, optional] netBufferPoolHandle

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

[in] allocateCloneFlags

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

[out] netBufferListChain

複製されたすべてのストリームデータを記述する NET_BUFFER_LIST 構造体のチェーンへのポインターを受け取る場所へのポインター。

戻り値

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

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

解説

この複製されたストリームデータは、コールアウトドライバーによって後で TCP/IP ネットワークスタックに挿入できます。

FwpsCloneStreamData0 関数は、既存のFWPS_STREAM_DATA0 データストリームに含まれるNET_BUFFER_LIST構造体のチェーン全体を複製します。関数は、コールアウトドライバーが複製されたチェーンを正常にに渡すことができるよう、未使用のデータをトリミングします。 FwpsStreamInjectAsync0 関数。

複製NET_BUFFER_LIST構造体チェーン内のストリームデータがネットワークスタックに正常に挿入された後、複製NET_BUFFER_LIST構造体ごとに completionFn 吹き出し関数が呼び出され、コールアウトで FwpsFreeCloneNetBufferList0 を呼び出して、複製NET_BUFFER_LIST構造体を解放する必要があります。

複製されたストリームデータを再挿入せずに破棄する場合は、吹き出しで FwpsDiscardClonedStreamData0 関数を呼び出す必要があります。

要件

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