Freigeben über


NdisFSendNetBufferListsComplete-Funktion (ndis.h)

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)

Weitere Informationen

FilterAttach

FilterSendNetBufferLists

NET_BUFFER

NET_BUFFER_LIST