NDIS_SWITCH_FREE_NET_BUFFER_LIST_FORWARDING_CONTEXT Rückruffunktion (ndis.h)

Die FreeNetBufferListForwardingContext-Funktion gibt Ressourcen im erweiterbaren OOB(Out-of-Band)-Switchweiterleitungskontext einer NET_BUFFER_LIST-Struktur frei. Diese Daten wurden für Sende- oder Empfangsvorgänge in einem erweiterbaren Hyper-V-Switch verwendet und zuvor durch Aufrufen der AllocateNetBufferListForwardingContext-Funktion zugeordnet.

Syntax

NDIS_SWITCH_FREE_NET_BUFFER_LIST_FORWARDING_CONTEXT NdisSwitchFreeNetBufferListForwardingContext;

void NdisSwitchFreeNetBufferListForwardingContext(
  [in]      NDIS_SWITCH_CONTEXT NdisSwitchContext,
  [in, out] PNET_BUFFER_LIST NetBufferList
)
{...}

Parameter

[in] NdisSwitchContext

Ein NDIS_SWITCH_CONTEXT Wert, der das Handle des erweiterbaren Switchmoduls enthält, an das die erweiterbare Hyper-V-Switcherweiterung angefügt ist. Wenn die Erweiterung NdisFGetOptionalSwitchHandlers aufruft, wird dieses Handle über den NdisSwitchContext-Parameter zurückgegeben.

[in, out] NetBufferList

Ein Zeiger auf eine verknüpfte Liste von NET_BUFFER_LIST Strukturen.

Hinweis Diese Struktur muss einen erweiterbaren Switchweiterleitungskontext enthalten, der zuvor durch Aufrufen der AllocateNetBufferListForwardingContext-Funktion zugeordnet wurde.

 

Rückgabewert

Wenn der Aufruf erfolgreich ist, gibt die Funktion NDIS_STATUS_SUCCESS zurück. Andernfalls wird ein NDIS_STATUS_Xxx-Fehlercode zurückgegeben, der in Ndis.h definiert ist.

Hinweise

Die erweiterbare Switcherweiterung kann Paketsendevorgänge innerhalb des erweiterbaren Switch-Datenpfads erstellen. Beispielsweise kann die Erweiterung Pakete an einen beliebigen Port des erweiterbaren Switches senden. Weitere Informationen zu diesem Datenpfad finden Sie unter Hyper-V Extensible Switch Data Path.

Wenn die erweiterbare Switcherweiterung von einem Paketsendevorgang stammt, muss die Erweiterung die AllocateNetBufferListForwardingContext-Funktion aufrufen. Diese Funktion ordnet den Weiterleitungskontext für die angegebene NET_BUFFER_LIST-Struktur zu und initialisiert diesen. Weitere Informationen zu diesem Kontext finden Sie unter Hyper-V Extensible Switch Forwarding Context.For more information about this context, see Hyper-V Extensible Switch Forwarding Context.

Wenn der Sendevorgang abgeschlossen ist, muss die Erweiterung die FreeNetBufferListForwardingContext-Funktion aufrufen, um die Zuordnung des Weiterleitungskontexts zu aufheben.

Hinweis Die Erweiterung muss die FreeNetBufferListForwardingContext-Funktion aufrufen, wenn der Sendevorgang abgeschlossen ist. Die Erweiterung muss dies unabhängig davon tun, ob sie die NET_BUFFER_LIST-Struktur des Pakets einer Lookaside-Liste hinzufügt oder NdisFreeNetBufferList aufruft, um die Struktur an einen Pool zurückzugeben.

 

Weitere Informationen zum Erstellen von Sendevorgängen finden Sie unter Filtern von Sende- und Empfangsvorgängen für Module.

Hinweis Wenn der NetBufferList-Parameter einen Zeiger auf eine verknüpfte Liste mehrerer NET_BUFFER_LIST-Strukturen enthält, wird nur für die erste NET_BUFFER_LIST Struktur in der Liste der Weiterleitungskontext die Zuordnung aufgehoben.

 

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt in NDIS 6.30 und höher.
Zielplattform	Desktop
Kopfzeile	ndis.h (include Ndis.h)
IRQL	<= DISPATCH_LEVEL

Weitere Informationen

AllocateNetBufferListForwardingContext

NET_BUFFER_LIST

NdisFGetOptionalSwitchHandlers

NdisFreeNetBufferList