NdisFSendNetBufferListsComplete-Funktion (ndis.h)

Artikel
02/07/2025

Filtertreiber rufen die NdisFSendNetBufferListsComplete--Funktion auf, um eine verknüpfte Liste von NET_BUFFER_LIST Strukturen an einen übermäßigen Treiber zurückzugeben und den endgültigen 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 den Handle an den Filtertreiber in einem Aufruf der FilterAttach--Funktion ü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 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 Kennzeichen finden Sie unter 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 Hyper-V erweiterbaren Switch-Quellport.

Weitere Informationen finden Sie unter 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 Kennzeichen ist in NDIS 6.30 und höher verfügbar.

Rückgabewert

Nichts

Bemerkungen

Ein Filtertreiber ruft die NdisFSendNetBufferListsComplete--Funktion auf, um Sendeanforderungen auszuführen, 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 der Status der Sendeanforderungen aussteht, 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 einer FilterSendNetBufferLists Aufruf aufteilen. Der Filtertreiber darf jedoch nicht die Liste der NET_BUFFER Strukturen ändern, die einer NET_BUFFER_LIST Struktur zugeordnet sind.

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

Anforderungen

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