NdisFSendNetBufferListsComplete 函式 (ndis.h)

發行項
03/01/2024

篩選驅動程式會呼叫 NdisFSendNetBufferListsComplete 函式，將 NET_BUFFER_LIST 結構的連結清單傳回至過度配置驅動程式，並傳回傳送要求的最終狀態。

語法

void NdisFSendNetBufferListsComplete(
  [in] NDIS_HANDLE      NdisFilterHandle,
       PNET_BUFFER_LIST NetBufferList,
  [in] ULONG            SendCompleteFlags
);

參數

[in] NdisFilterHandle

識別此篩選模組的 NDIS 句柄。 NDIS 在對 FilterAttach 函式的呼叫中，將句柄傳遞至篩選驅動程式。

NetBufferList

NET_BUFFER_LIST 結構連結清單的指標。篩選驅動程式在先前對的呼叫中收到 NET_BUFFER_LIST 結構 FilterSendNetBufferLists 函式。

[in] SendCompleteFlags

可與 OR 作業結合的 NDIS 旗標。若要清除所有旗標，請將此成員設定為零。此函式支援下列旗標：

NDIS_SEND_COMPLETE_FLAGS_DISPATCH_LEVEL

指定目前的 IRQL DISPATCH_LEVEL。如需此旗標的詳細資訊，請參閱分派 IRQL 追蹤。

NDIS_SEND_COMPLETE_FLAGS_SWITCH_SINGLE_SOURCE

如果已設定此旗標，則 NET_BUFFER_LIST結構連結清單中的所有封包都源自相同的 Hyper-V 可延伸交換器來源埠。

如需詳細資訊，請參閱 Hyper-V 可延伸交換器傳送和接收旗標。

注意如果連結NET_BUFFER_LIST結構清單中的每個封包都使用相同的來源埠，擴充功能應該在 NdisFSendNetBufferLists 的 SendFlags 參數中設定NDIS_SEND_FLAGS_SWITCH_SINGLE_SOURCE旗標。

注意此旗標適用於 NDIS 6.30 和更新版本。

傳回值

無

備註

篩選驅動程式會呼叫 NdisFSendNetBufferListsComplete 函式，以完成 NDIS 對驅動程式所做的傳送要求 FilterSendNetBufferLists 函式。篩選驅動程式會指定與已完成傳送要求相關聯的 NET_BUFFER_LIST 結構連結清單。當傳送要求的狀態擱置中時，篩選驅動程式會保留 NET_BUFFER_LIST 結構的擁有權，以及與 NET_BUFFER_LIST 結構相關聯的所有資源。

篩選驅動程式可以依任何順序完成傳送要求。例如，篩選驅動程式可以從多個 FilterSendNetBufferLists 呼叫串連NET_BUFFER_LIST結構清單，或從 FilterSendNetBufferLists 呼叫分割清單。不過，篩選驅動程式不得修改與NET_BUFFER_LIST結構相關聯的NET_BUFFER結構清單。

注意篩選驅動程式應該追蹤其來源的傳送要求，並確定它不會呼叫當這類要求完成時，NdisFSendNetBufferListsComplete 函式。

規格需求

需求	值
最低支援的用戶端	NDIS 6.0 和更新版本支援。
目標平台	桌面
標頭	ndis.h (包括 Ndis.h)
程式庫	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI 合規性規則	Irql_Filter_Driver_Function (ndis)