NdisFSendNetBufferLists 函式 (ndis.h)

發行項
03/05/2024

篩選驅動程式會呼叫 NdisFSendNetBufferLists 函式來傳送網路數據緩衝區清單。

語法

void NdisFSendNetBufferLists(
  [in] NDIS_HANDLE                       NdisFilterHandle,
       __drv_aliasesMem PNET_BUFFER_LIST NetBufferList,
  [in] NDIS_PORT_NUMBER                  PortNumber,
  [in] ULONG                             SendFlags
);

參數

[in] NdisFilterHandle

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

NetBufferList

NET_BUFFER_LIST 結構連結清單的指標。每個 NET_BUFFER_LIST 結構都會描述 NET_BUFFER 結構的清單。

[in] PortNumber

識別迷你埠配接器埠的埠號碼。 Miniport 配接器埠號碼是藉由呼叫 NdisMAllocatePort 函式來指派。零值會識別迷你埠配接器的預設埠。

[in] SendFlags

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

NDIS_SEND_FLAGS_DISPATCH_LEVEL

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

NDIS_SEND_FLAGS_CHECK_FOR_LOOPBACK

指定 NDIS 應該檢查回送。根據預設，NDIS 不會將數據回送至提交傳送要求的驅動程式。過度處理驅動程式可以藉由設定此旗標來覆寫此行為。設定此旗標時，NDIS 會識別包含符合系結接收準則之數據的所有 NET_BUFFER 結構。 NDIS 表示NET_BUFFER結構，這些結構符合準則與超載驅動程式。此旗標不會影響檢查回送或其他系結上的回送或回送。

NDIS_SEND_FLAGS_SWITCH_SINGLE_SOURCE

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

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

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

注意此旗標可在 NDIS 6.30 和更新版本中使用。

NDIS_SEND_FLAGS_SWITCH_DESTINATION_GROUP

如果設定此旗標，則NET_BUFFER_LIST 結構連結清單中的所有封包都會轉送到相同的可延伸交換器目的地埠。

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

注意此旗標可在 NDIS 6.30 和更新版本中使用。

傳回值

無

備註

篩選驅動程式呼叫 NdisFSendNetBufferLists 函式之後，NDIS 會將 NET_BUFFER_LIST 結構提交至基礎驅動程式。

篩選驅動程式可能源自傳送要求，也可以篩選從過度處理驅動程式收到的要求。如果篩選驅動程式源自傳送要求，驅動程式必須配置緩衝池。篩選驅動程式會從集區配置每個 NET_BUFFER_LIST 結構。

篩選驅動程式可以預先配置 NET_BUFFER_LIST結構，也可以在呼叫 NdisFSendNetBufferLists 之前配置結構，然後在傳送作業完成時釋放它們。

篩選驅動程式必須設定每個NET_BUFFER_LIST結構的SourceHandle成員，其源自於傳遞給NdisFilterHandle 參數的相同值。篩選句柄會提供 NDIS 將 NET_BUFFER_LIST 結構傳回至篩選驅動程式所需的資訊。篩選驅動程式不得修改其未產生之任何NET_BUFFER_LIST結構中的SourceHandle成員。

在呼叫 NdisFSendNetBufferLists 之前，篩選驅動程式可以設定傳送要求隨附 NET_BUFFER_LIST_INFO 宏的資訊。基礎驅動程式可以使用 NET_BUFFER_LIST_INFO 宏來擷取此資訊。

NDIS 會呼叫篩選驅動程式的 FilterSendNetBufferLists 函式，以傳遞來自過度驅動程序的傳送要求。篩選驅動程式可以將在 FilterSendNetBufferLists 中收到的NET_BUFFER_LISTT 結構傳遞至 NdisFSendNetBufferLists，以傳遞這類要求。

一旦篩選驅動程式呼叫 NdisFSendNetBufferLists 函式，就會放棄 NET_BUFFER_LIST 結構和所有相關聯資源的擁有權。 NDIS 會呼叫 FilterSendNetBufferListsComplete 函式，以將結構和數據傳回至篩選驅動程式。 NDIS 可以在將清單傳遞至 FilterSendNetBufferListsComplete 之前，先將多個傳送要求的結構和數據收集到單一連結的 NET_BUFFER_LIST 結構清單。

在 NDIS 呼叫 FilterSendNetBufferListsComplete 之前，篩選驅動程式無法使用傳送要求的目前狀態。篩選驅動程式會在呼叫 NdisFSendNetBufferLists 時，暫時釋放與傳送要求相關聯的所有資源的擁有權。在呼叫 NdisFSendNetBufferLists 之後，篩選驅動程式不應該嘗試檢查NET_BUFFER_LIST結構或任何相關聯的數據。

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

規格需求

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