NdisFReturnNetBufferLists-Funktion (ndis.h)

Artikel
08/07/2023

Filtertreiber rufen NdisFReturnNetBufferLists auf, um den Besitz einer oder mehrerer NET_BUFFER_LIST-Strukturen und der zugehörigen NET_BUFFER-Strukturen freizugeben.

Syntax

void NdisFReturnNetBufferLists(
  [in] NDIS_HANDLE      NdisFilterHandle,
  [in] PNET_BUFFER_LIST NetBufferLists,
  [in] ULONG            ReturnFlags
);

Parameter

[in] NdisFilterHandle

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

[in] NetBufferLists

Ein Zeiger auf eine verknüpfte Liste von NET_BUFFER_LIST Strukturen, die an den zugrunde liegenden Treiber zurückgegeben werden sollen. Die verknüpfte Liste kann NET_BUFFER_LIST Strukturen aus mehreren vorherigen Aufrufen der FilterReceiveNetBufferLists-Funktion .

[in] ReturnFlags

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_RETURN_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_RETURN_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 beim Senden der Anforderung das flag NDIS_RECEIVE_FLAGS_SWITCH_SINGLE_SOURCE im ReceiveFlags-Parameter von NdisFIndicateReceiveNetBufferLists festlegen.

Rückgabewert

Keine

Bemerkungen

Wenn das NDIS_RECEIVE_FLAGS_RESOURCES Flag im ReceiveFlags-Parameter , das NDIS an die übergeben hat Die FilterReceiveNetBufferLists-Funktion wurde nicht festgelegt. Der Filtertreiber muss die Funktion NdisFReturnNetBufferLists aufrufen, um die NET_BUFFER_LIST Strukturen und zugeordneten Daten zurückzugeben. Nachdem der Filtertreiber NdisFReturnNetBufferLists aufgerufen hat, gibt NDIS die Daten an den zugrunde liegenden Treiber zurück.

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)