NdisMSendNetBufferListsComplete 関数 (ndis.h)

[アーティクル]
02/26/2024

ミニポートドライバーは NdisMSendNetBufferListsComplete 関数を呼び出して、 NET_BUFFER_LIST構造体のリンクされたリストを上にあるドライバーに返し、送信要求の最終状態を返します。

構文

void NdisMSendNetBufferListsComplete(
  [in] NDIS_HANDLE      MiniportAdapterHandle,
       PNET_BUFFER_LIST NetBufferList,
  [in] ULONG            SendCompleteFlags
);

パラメーター

[in] MiniportAdapterHandle

NDIS が MiniportInitializeEx 関数に渡したミニポートハンドル。

NetBufferList

NET_BUFFER_LIST構造体のリンクされたリストへのポインター。ミニポートドライバーは、そのミニポートSendNetBufferLists 関数への以前の呼び出しでNET_BUFFER_LIST構造体を受信しました。

[in] SendCompleteFlags

OR 操作と組み合わせることができる NDIS フラグ。すべてのフラグをクリアするには、このメンバーを 0 に設定します。この関数は、NDIS_SEND_COMPLETE_FLAGS_DISPATCH_LEVEL フラグをサポートします。が設定されている場合は、現在の IRQL がDISPATCH_LEVELされていることを示します。このフラグの詳細については、「ディスパッチ IRQL 追跡」を参照してください。

戻り値

なし

解説

ミニポートドライバーは 、NdisMSendNetBufferListsComplete を呼び出して、NDIS がドライバーの MiniportSendNetBufferLists 関数に対して行った送信要求を完了します。ミニポートドライバーは、完了した送信要求に関連付けられている NET_BUFFER_LIST 構造体のリンクされた一覧を指定します。送信要求の状態が保留中の間、ミニポートドライバーは、NET_BUFFER_LIST構造体と、NET_BUFFER_LIST構造体に関連付けられているすべてのプロトコル割り当てリソースの所有権を保持します。

ミニポートドライバーが NdisMSendNetBufferListsComplete を呼び出した後、NDIS は、送信要求を開始するために NdisSendNetBufferLists 関数を呼び出したドライバーの ProtocolSendNetBufferListsComplete 関数を呼び出します。

ミニポートドライバーは、任意の順序で送信要求を完了できます。たとえば、ミニポートドライバーは、複数の MiniportSendNetBufferLists 呼び出しからNET_BUFFER_LIST構造リストを連結したり、 MiniportSendNetBufferLists 呼び出しからリストを分割したりできます。ただし、ミニポートドライバーは、NET_BUFFER_LIST構造体に関連付けられている NET_BUFFER 構造体の一覧を変更することはできません。

ミニポートドライバーは、NetBufferLists パラメーターが指定する各NET_BUFFER_LIST構造体の Status メンバーに次のいずれかの状態コードを設定する必要があります。

構造体	説明
NDIS_STATUS_SUCCESS	NET_BUFFER_LIST構造および関連するNET_BUFFER構造が記述するすべてのネットワーク・データは、伝送のために正常に処理されました。たとえば、ミニポートドライバーは、キューにデータをコピーするか、データが既に送信されています。
NDIS_STATUS_INVALID_LENGTH	このNET_BUFFER_LIST構造に関連付けられている一部のNET_BUFFER構造体内のデータのサイズが、基になる NIC に対して大きすぎます。
NDIS_STATUS_RESOURCES	リソースが不足しているため、このNET_BUFFER_LIST構造体の送信要求が失敗しました。
NDIS_STATUS_PAUSED	ミニポートアダプターは、ミニポートPause 関数のリファレンスページで説明されているように、一時停止状態です。
NDIS_STATUS_SEND_ABORTED	NDIS は、このNET_BUFFER_LIST構造体の送信操作を取り消すために、MiniportCancelSend 関数を呼び出しました。
NDIS_STATUS_RESET_IN_PROGRESS	ミニポートドライバーは、リセットのために送信要求を中止しました。
NDIS_STATUS_FAILURE	ミニポートドライバーは、前に説明した以外の何らかの理由で送信要求に失敗しました。たとえば、ミニポートドライバーは、ハードウェア障害が原因で送信要求を失敗させることができます。

NdisMSendNetBufferListsComplete へのミニポートドライバーの呼び出しは、送信要求のデータがネットワーク経由で送信されたことを必ずしも意味するとは限りません。データは NIC ハードウェアでキューに入れられます。

要件

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