Auf Englisch lesen

Freigeben über


NdisFReturnNetBufferLists-Funktion (ndis.h)

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 den Handle an den Filtertreiber in einem Aufruf der FilterAttach--Funktion ü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 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 Kennzeichen finden Sie unter 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 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_RECEIVE_FLAGS_SWITCH_SINGLE_SOURCE Flag im ReceiveFlags Parameter von NdisFIndicateReceiveNetBufferLists festlegen, wenn sie die Anforderung sendet.
 

Rückgabewert

Nichts

Bemerkungen

If the NDIS_RECEIVE_FLAGS_RESOURCES flag in the ReceiveFlags parameter that NDIS passed to the FilterReceiveNetBufferLists--Funktion nicht festgelegt wurde, muss der Filtertreiber die NdisFReturnNetBufferLists-funktion aufrufen, um die NET_BUFFER_LIST Strukturen und zugeordneten Daten zurückzugeben. Nachdem der Filtertreiber NdisFReturnNetBufferListsaufgerufen hat, gibt NDIS die Daten an den zugrunde liegenden Treiber zurück.

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)

Siehe auch

FilterAttach-

FilterReceiveNetBufferLists

NET_BUFFER

NET_BUFFER_LIST