FILTER_RETURN_NET_BUFFER_LISTS コールバック関数 (ndis.h)

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

NDIS は FilterReturnNetBufferLists 関数を呼び出して、 NET_BUFFER_LIST 構造体と関連付けられたデータのリンクされたリストをフィルタードライバーに返します。

メモFILTER_RETURN_NET_BUFFER_LISTS型を使用して関数を宣言する必要があります。詳細については、次の例に関するセクションを参照してください。

構文

FILTER_RETURN_NET_BUFFER_LISTS FilterReturnNetBufferLists;

void FilterReturnNetBufferLists(
  [in] NDIS_HANDLE FilterModuleContext,
  [in] PNET_BUFFER_LIST NetBufferLists,
  [in] ULONG ReturnFlags
)
{...}

パラメーター

[in] FilterModuleContext

フィルターモジュールのコンテキスト領域へのハンドル。フィルタードライバーは、 FilterAttach 関数でこのコンテキスト領域を作成および初期化しました。

[in] NetBufferLists

フィルタードライバーがを呼び出して示した NET_BUFFER_LIST 構造体のリンクされた一覧 NdisFIndicateReceiveNetBufferLists 関数。リストには、NdisFIndicateReceiveNetBufferLists への複数の呼び出しからNET_BUFFER_LIST構造体を含めることができます。

[in] ReturnFlags

OR 操作と組み合わせることができる NDIS フラグ。すべてのフラグをクリアするには、このメンバーを 0 に設定します。この関数は、次のフラグをサポートしています。

NDIS_RETURN_FLAGS_DISPATCH_LEVEL

現在の IRQL がDISPATCH_LEVELされることを指定します。このフラグの詳細については、「ディスパッチ IRQL 追跡」を参照してください。

NDIS_RETURN_FLAGS_SWITCH_SINGLE_SOURCE

このフラグが設定されている場合、 NET_BUFFER_LIST 構造のリンクされたリスト内のすべてのパケットは、同じ Hyper-V 拡張可能スイッチのソースポートから送信されます。

詳細については、「 Hyper-V 拡張可能スイッチの送受信フラグ」を参照してください。

メモNET_BUFFER_LIST構造体のリンクされたリスト内の各パケットが同じソースポートを使用する場合、拡張機能は、要求の送信時に FilterReceiveNetBufferLists の ReceiveFlags パラメーターにNDIS_RECEIVE_FLAGS_SWITCH_SINGLE_SOURCE フラグを設定する必要があります。

戻り値

なし

解説

FilterReturnNetBufferLists は省略可能な関数です。フィルタードライバーが受信インジケーターをフィルター処理しない場合は、を呼び出すときに、この関数のエントリポイントを NULL に設定できます。 NdisFRegisterFilterDriver 関数。

フィルタードライバーは、 FilterSetModuleOptions 関数から NdisSetOptionalHandlers 関数を呼び出して、フィルターモジュールの FilterReturnNetBufferLists 関数を指定できます。

メモFilterReturnNetBufferLists 関数を提供しないフィルタードライバーは、 NdisFIndicateReceiveNetBufferLists 関数を使用して、受信通知を開始します。

メモFilterReturnNetBufferLists 関数を提供するフィルタードライバーは、FilterStatus 関数を提供する必要があります。

NDIS が FilterReturnNetBufferLists を呼び出すと、フィルタードライバーは NET_BUFFER_LIST 構造体と関連データの所有権を回復します。

基になるドライバーが受信表示を開始した場合、フィルタードライバーはを呼び出す必要があります。 NdisFReturnNetBufferLists 関数を使用して、受信表示を完了します。

フィルタードライバーが受信表示を開始した場合、 FilterReturnNetBufferLists は、NET_BUFFER_LIST構造体と関連付けられたデータを解放するか、 NdisFIndicateReceiveNetBufferLists への後続の呼び出しで再利用できるように準備できます。

フィルタードライバーは、開始した受信インジケーターを追跡し、 NDIS が FilterReturnNetBufferLists を呼び出すときに NdisFReturnNetBufferLists を呼び出していないことを確認する必要があります。

NDIS は、IRQL <= DISPATCH_LEVELで FilterReturnNetBufferLists を呼び出します。

例

FilterReturnNetBufferLists 関数を定義するには、まず、定義する関数の型を識別する関数宣言を指定する必要があります。 Windows には、ドライバーの関数型のセットが用意されています。関数の種類を使用して関数を宣言すると、ドライバーのコード分析、静的ドライバー検証ツール (SDV)、およびその他の検証ツールでエラーが検出され、Windows オペレーティングシステム用のドライバーを記述するための要件になります。

たとえば、" MyReturnNetBufferLists" という名前の FilterReturnNetBufferLists 関数を定義するには、次のコード例に示すように 、FILTER_RETURN_NET_BUFFER_LISTS 型を使用します。

FILTER_RETURN_NET_BUFFER_LISTS MyReturnNetBufferLists;

次に、次のように関数を実装します。

_Use_decl_annotations_
VOID
 MyReturnNetBufferLists(
    NDIS_HANDLE  FilterModuleContext,
    PNET_BUFFER_LIST  NetBufferLists,
    ULONG  ReturnFlags
    )
  {...}

FILTER_RETURN_NET_BUFFER_LISTS関数の種類は、Ndis.h ヘッダーファイルで定義されます。コード分析ツールを実行するときにエラーをより正確に識別するには、 Use_decl_annotations 注釈を関数定義に追加してください。 Use_decl_annotations注釈を使用すると、ヘッダーファイル内のFILTER_RETURN_NET_BUFFER_LISTS関数型に適用される注釈が確実に使用されます。関数宣言の要件の詳細については、「NDIS ドライバーの関数ロール型を使用して関数を宣言する」を参照してください。

Use_decl_annotationsの詳細については、「関数の動作に注釈を付ける」を参照してください。

要件

要件	値
サポートされている最小のクライアント	NDIS 6.0 以降でサポートされています。
対象プラットフォーム	Windows
ヘッダー	ndis.h (Ndis.h を含む)
IRQL	<= DISPATCH_LEVEL