NDIS_SWITCH_ADD_NET_BUFFER_LIST_DESTINATION Rückruffunktion (ndis.h)

Artikel
02/26/2024

Die AddNetBufferListDestination-Funktion fügt einen einzelnen Zielport für ein Paket hinzu, das durch eine NET_BUFFER_LIST-Struktur angegeben wird.

Syntax

NDIS_SWITCH_ADD_NET_BUFFER_LIST_DESTINATION NdisSwitchAddNetBufferListDestination;

NDIS_STATUS NdisSwitchAddNetBufferListDestination(
  [in]      NDIS_SWITCH_CONTEXT NdisSwitchContext,
  [in, out] PNET_BUFFER_LIST NetBufferList,
  [in]      PNDIS_SWITCH_PORT_DESTINATION Destination
)
{...}

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 NET_BUFFER_LIST-Struktur für ein Paket.

Hinweis Diese Struktur muss einen erweiterbaren Switchweiterleitungskontext enthalten. Wenn die Erweiterung das Paket erstellt oder geklont hat, muss sie diese Struktur zuvor durch Aufrufen der AllocateNetBufferListForwardingContext-Funktion zugeordnet haben.

[in] Destination

Ein Zeiger auf eine NDIS_SWITCH_PORT_DESTINATION-Struktur . Diese Struktur gibt den erweiterbaren Switchport des Ziels an, an den das Paket weitergeleitet wird.

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 erweiterung des erweiterbaren Weiterleitungsswitches ruft AddNetBufferListDestination auf, um einen einzelnen erweiterbaren Switchzielport für ein Paket zu definieren. Die Erweiterung gibt diesen Port an, indem eine NDIS_SWITCH_PORT_DESTINATION-Struktur initialisiert wird. Die Erweiterung legt den Parameter Destination auf einen Zeiger auf diese Struktur fest. Weitere Informationen zum Angeben eines erweiterbaren Switch-Zielports finden Sie unter Verwalten von Zielportdaten für den erweiterbaren Hyper-V-Switch.

Hinweis Aus Leistungsgründen sollte die Erweiterung keine AddNetBufferListDestination-Pakete mit mehreren Zielports aufrufen.

Die Erweiterung muss die folgenden Richtlinien befolgen, bevor AddNetBufferListDestination aufgerufen wird:

Nur Weiterleitungserweiterungen können AddNetBufferListDestination aufrufen, um einen Zielport für ein Paket hinzuzufügen. Weitere Informationen zu diesem Erweiterungstyp finden Sie unter Weiterleitungserweiterungen.
Wenn die Weiterleitungserweiterung von einem Paket mit einem Zielport stammt, muss die Erweiterung zuerst die AllocateNetBufferListForwardingContext-Funktion aufrufen. Diese Funktion ordnet dem Paket den erweiterbaren Switchweiterleitungskontext zu. Diese Daten enthalten die erweiterbaren Switchquell- und Zielports innerhalb der Out-of-Band-Informationen (OOB) für das Paket.
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.
Nachdem die Erweiterung die Zielportinformationen in der NDIS_SWITCH_PORT_DESTINATION-Struktur geändert hat, ruft sie AddNetBufferListDestination auf, um die Änderungen an die NET_BUFFER_LIST-Struktur für das Paket zu committen.
Hinweis Aus Leistungsgründen sollte die Erweiterung die UpdateNetBufferListDestinations-Funktion nicht aufrufen, um die Änderungen für das Paket zu committen.

Hinweis Nachdem die Weiterleitungserweiterung die Änderungen für Zielports in den Weiterleitungskontext committet hat, können Zielports nicht entfernt werden, und nur das IsExcluded-Element der NDIS_SWITCH_PORT_DESTINATION-Struktur eines Zielports kann geändert werden. Weitere Informationen finden Sie unter Ausschließen der Paketübermittlung an erweiterbare Switch-Zielports.

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