NdisFReturnNetBufferLists 関数 (ndis.h)

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

フィルタードライバーは 、NdisFReturnNetBufferLists を呼び出して、1 つ以上の NET_BUFFER_LIST 構造体とそれに関連付けられている NET_BUFFER 構造体の所有権を解放します。

構文

void NdisFReturnNetBufferLists(
  [in] NDIS_HANDLE      NdisFilterHandle,
  [in] PNET_BUFFER_LIST NetBufferLists,
  [in] ULONG            ReturnFlags
);

パラメーター

[in] NdisFilterHandle

このフィルターモジュールを識別する NDIS ハンドル。 NDIS は FilterAttach 関数の呼び出しでフィルタードライバーにハンドルを渡しました。

[in] NetBufferLists

基になるドライバーに返されるNET_BUFFER_LIST構造体のリンクされたリストへのポインター。リンクリストには、への複数の以前の呼び出しからNET_BUFFER_LIST構造を含めることができます。 FilterReceiveNetBufferLists 関数。

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

戻り値

なし

解説

NDIS がに渡した ReceiveFlags パラメーターのNDIS_RECEIVE_FLAGS_RESOURCES フラグ FilterReceiveNetBufferLists 関数が設定されていません。フィルタードライバーは NdisFReturnNetBufferLists 関数を呼び出して、NET_BUFFER_LIST 構造体と関連データを返す必要があります。フィルタードライバーが NdisFReturnNetBufferLists を呼び出した後、NDIS は基になるドライバーにデータを返します。

要件

要件	値
サポートされている最小のクライアント	NDIS 6.0 以降でサポートされています。
対象プラットフォーム	デスクトップ
Header	ndis.h (Ndis.h を含む)
Library	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI コンプライアンス規則	Irql_Filter_Driver_Function(ndis)