NdisSendNetBufferLists 関数 (ndis.h)

[アーティクル]
02/07/2025

プロトコルドライバーは、NdisSendNetBufferLists 関数を呼び出して、NET_BUFFER_LIST 構造体の一覧に含まれるネットワークデータを送信します。

構文

void NdisSendNetBufferLists(
  [in] NDIS_HANDLE                       NdisBindingHandle,
  [in] __drv_aliasesMem PNET_BUFFER_LIST NetBufferLists,
  [in] NDIS_PORT_NUMBER                  PortNumber,
  [in] ULONG                             SendFlags
);

パラメーター

[in] NdisBindingHandle

ターゲットアダプターを識別するハンドル。 NdisOpenAdapterEx 以前の呼び出しで、このハンドルが返されました。

[in] NetBufferLists

NET_BUFFER_LIST 構造体のリンクされたリストへのポインター。各NET_BUFFER_LIST構造体は、NET_BUFFER 構造体の一覧を記述します。

[in] PortNumber

ミニポートアダプターのポートを識別するポート番号。ミニポートアダプターの既定のポート番号は 0 です。ミニポートアダプターポートを使用しないプロトコルドライバーは、既定のポートを指定する必要があります。

[in] SendFlags

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

NDIS_SEND_FLAGS_DISPATCH_LEVEL

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

NDIS_SEND_FLAGS_CHECK_FOR_LOOPBACK

NDIS がループバックをチェックする必要があることを指定します。既定では、NDIS は、送信要求を送信したドライバーにデータをループバックしません。基になるドライバーは、このフラグを設定することで、この動作をオーバーライドできます。このフラグを設定すると、NDIS は、バインディングの受信条件に一致するデータを含むすべてのNET_BUFFER構造体を識別します。 NDIS は、基になるドライバーに条件に一致するNET_BUFFER構造体を示します。このフラグは、ループバックのチェックや、他のバインドでのループバックには影響しません。

戻り値

何一つ

備考

プロトコルドライバーが NdisSendNetBufferLists 呼び出した後、NDIS は基になるドライバーの NET_BUFFER_LIST 構造体を送信します。ミニポートSendNetBufferLists 関数です。

プロトコルドライバーは、次のいずれかの関数を呼び出して、プールから各NET_BUFFER_LIST構造体を割り当てる必要があります。

NdisAllocateNetBufferList の
NdisAllocateNetBufferAndNetBufferList の
NdisAllocateCloneNetBufferList の

プロトコルドライバーは、DriverEntry ルーチンなど、NET_BUFFER_LIST構造体を事前に割り当てることができます。または、ドライバーは、NdisSendNetBufferLists を呼び出す直前に構造体を割り当て、送信操作が完了したときに解放できます。 NDIS がNET_BUFFER_LIST構造体を返す場合ProtocolSendNetBufferListsComplete 、ミニポートドライバーは、NET_BUFFER_LIST構造体と、再利用するために関連するリソースを準備できます。 NET_BUFFER_LIST構造体を再利用すると、構造体をプールに返し、別の送信操作のために再割り当てするよりもパフォーマンスが向上する可能性があります。

プロトコルドライバーは、各NET_BUFFER_LIST構造体の SourceHandle メンバーを、NdisBindingHandle パラメーターに渡すのと同じ値に設定する必要があります。バインディングハンドルは、基になるミニポートドライバーの呼び出し後に、NDIS がプロトコルドライバーにNET_BUFFER_LIST構造体を返すために必要な情報を提供します。NdisMSendNetBufferListsComplete をします。

NdisSendNetBufferLists 呼び出す前に、プロトコルドライバーは、NET_BUFFER_LIST_INFO マクロで送信要求に付随する情報を設定できます。基になるドライバーは、NET_BUFFER_LIST_INFO マクロを使用してこの情報を取得できます。

プロトコルドライバーは、NET_BUFFER_LIST構造体の一覧を使用して ndisSendNetBufferLists 呼び出す前に、ネットワークデータをネットワーク経由で送信する順序でNET_BUFFER_LIST構造体が設定されていることを確認する必要があります。

プロトコルドライバーが NdisSendNetBufferLists 呼び出されるとすぐに、NET_BUFFER_LIST構造体と関連するすべてのリソースの所有権が放棄されます。 NDIS は、ProtocolSendNetBufferListsComplete 関数を呼び出して、構造体とデータをプロトコルドライバーに返します。 NDIS では、ProtocolSendNetBufferListsComplete にリストを渡す前に、複数の送信要求から NET_BUFFER_LIST 構造体の単一のリンクされたリストに構造体とデータ 収集できます。

NDIS が ProtocolSendNetBufferListsComplete 呼び出すまで、プロトコルドライバーによって開始される送信の現在の状態は、プロトコルドライバーでは使用できません。プロトコルドライバーは、NdisSendNetBufferLists 呼び出すときに、送信要求に割り当てられたすべてのリソースの所有権を一時的に解放します。プロトコルドライバー NdisSendNetBufferLists を呼び出した後、NET_BUFFER_LIST構造体または関連するデータ調べようと しないでください。

必要条件

要件	価値
サポートされる最小クライアント	NDIS 6.0 以降でサポートされています。
ターゲットプラットフォームの	万国
ヘッダー	ndis.h (Ndis.h を含む)
ライブラリ	Ndis.lib
IRQL	<=DISPATCH_LEVEL
DDI コンプライアンス規則をする	Irql_SendRcv_Function(ndis)

次の方法で共有

NdisSendNetBufferLists 関数 (ndis.h)

構文

パラメーター

NDIS_SEND_FLAGS_DISPATCH_LEVEL

NDIS_SEND_FLAGS_CHECK_FOR_LOOPBACK

戻り値

備考

必要条件

関連項目

フィードバック

その他のリソース