NdisFSendNetBufferListsComplete-Funktion (ndis.h)

Artikel
08/07/2023

Filtertreiber rufen die NdisFSendNetBufferListsComplete-Funktion auf, um eine verknüpfte Liste von NET_BUFFER_LIST Strukturen an einen übergeordneten Treiber zurückzugeben und die endgültige status einer Sendeanforderung zurückzugeben.

Syntax

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

Parameter

[in] NdisFilterHandle

Das NDIS-Handle, das dieses Filtermodul identifiziert. NDIS hat das Handle in einem Aufruf der FilterAttach-Funktion an den Filtertreiber übergeben.

NetBufferList

Ein Zeiger auf eine verknüpfte Liste von NET_BUFFER_LIST Strukturen. Der Filtertreiber hat die NET_BUFFER_LIST Strukturen in vorherigen Aufrufen der FilterSendNetBufferLists-Funktion .

[in] SendCompleteFlags

NDIS-Flags, die mit einem OR-Vorgang kombiniert werden können. Um alle Flags zu löschen, legen Sie dieses Element auf 0 (null) fest. Diese Funktion unterstützt die folgenden Flags:

NDIS_SEND_COMPLETE_FLAGS_DISPATCH_LEVEL

Gibt an, dass die aktuelle IRQL DISPATCH_LEVEL ist. Weitere Informationen zu diesem Flag finden Sie unter Dispatch IRQL Tracking.For more information about this flag, see Dispatch IRQL Tracking.

NDIS_SEND_COMPLETE_FLAGS_SWITCH_SINGLE_SOURCE

Wenn dieses Flag festgelegt ist, stammen alle Pakete in einer verknüpften Liste von NET_BUFFER_LIST Strukturen vom gleichen erweiterbaren Hyper-V-Switch-Quellport.

Weitere Informationen finden Sie unter Hyper-V Extensible Switch Send and Receive Flags.For more information, see Hyper-V Extensible Switch Send and Receive Flags.

Hinweis Wenn jedes Paket in der verknüpften Liste der NET_BUFFER_LIST-Strukturen denselben Quellport verwendet, sollte die Erweiterung das NDIS_SEND_FLAGS_SWITCH_SINGLE_SOURCE-Flag im SendFlags-Parameter von NdisFSendNetBufferLists festlegen, wenn sie die Anforderung sendet.

Hinweis Dieses Flag ist in NDIS 6.30 und höher verfügbar.

Rückgabewert

Keine

Bemerkungen

Ein Filtertreiber ruft die NdisFSendNetBufferListsComplete-Funktion auf, um Sendeanforderungen abzuschließen, die NDIS an den Treiber gesendet hat. FilterSendNetBufferLists-Funktion . Der Filtertreiber gibt eine verknüpfte Liste von NET_BUFFER_LIST Strukturen an, die den abgeschlossenen Sendeanforderungen zugeordnet sind. Während die status der Sendeanforderungen ausstehend ist, behält der Filtertreiber den Besitz der NET_BUFFER_LIST-Strukturen und aller Ressourcen, die den NET_BUFFER_LIST-Strukturen zugeordnet sind.

Der Filtertreiber kann Sendeanforderungen in beliebiger Reihenfolge abschließen. Beispielsweise könnte der Filtertreiber die NET_BUFFER_LIST-Strukturlisten aus mehreren FilterSendNetBufferLists-Aufrufen verketten oder eine Liste aus einem FilterSendNetBufferLists-Aufruf aufteilen. Der Filtertreiber darf jedoch die Liste der NET_BUFFER Strukturen, die einer NET_BUFFER_LIST-Struktur zugeordnet sind, nicht ändern.

Hinweis Ein Filtertreiber sollte die Sendeanforderungen nachverfolgen, von denen er stammt, und sicherstellen, dass er nicht die NdisFSendNetBufferListsComplete-Funktion , wenn solche Anforderungen abgeschlossen sind.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt in NDIS 6.0 und höher.
Zielplattform	Desktop
Kopfzeile	ndis.h (include Ndis.h)
Bibliothek	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI-Complianceregeln	Irql_Filter_Driver_Function(ndis)