NDIS_SWITCH_SET_NET_BUFFER_LIST_SOURCE Rückruffunktion (ndis.h)

Artikel
08/07/2023

Die SetNetBufferListSource-Funktion legt den erweiterbaren Hyper-V-Switch-Quellportbezeichner und den Netzwerkadapterindex für ein Paket fest, das durch eine NET_BUFFER_LIST-Struktur angegeben wird.

Syntax

NDIS_SWITCH_SET_NET_BUFFER_LIST_SOURCE NdisSwitchSetNetBufferListSource;

NDIS_STATUS NdisSwitchSetNetBufferListSource(
  [in] NDIS_SWITCH_CONTEXT NdisSwitchContext,
       PNET_BUFFER_LIST NetBufferList,
  [in] NDIS_SWITCH_PORT_ID PortId,
  [in] NDIS_SWITCH_NIC_INDEX NicIndex
)
{...}

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 Parameter NdisSwitchContext zurückgegeben.

NetBufferList

Ein Zeiger auf eine NET_BUFFER_LIST-Struktur für ein einzelnes Paket.

Hinweis Diese Struktur muss einen erweiterbaren Switchweiterleitungskontext enthalten, der zuvor durch Aufrufen der Funktion AllocateNetBufferListForwardingContext zugeordnet wurde. Weitere Informationen zum Kontext der erweiterbaren Switchweiterleitung finden Sie unter Hyper-V Extensible Switch Forwarding Context.

[in] PortId

Ein NDIS_SWITCH_PORT_ID Wert, der den eindeutigen Bezeichner des Quellports auf dem erweiterbaren Switch angibt.

[in] NicIndex

Ein NDIS_SWITCH_NIC_INDEX Wert, der den Index des Netzwerkadapters angibt, der mit dem erweiterbaren Switchport verbunden ist, der durch den PortId-Parameter angegeben wird.

Weitere Informationen zu NDIS_SWITCH_NIC_INDEX Werten finden Sie unter Indexwerte des Netzwerkadapters.

Hinweis Dieser Parameter muss den Indexwert eines Netzwerkadapters angeben, der sich in einem verbundenen Zustand befindet. Indexwerte für Netzwerkadapter, die sich in einem erstellten oder getrennten Zustand befinden, können nicht angegeben werden. Weitere Informationen zu Netzwerkverbindungszuständen finden Sie unter Hyper-V Extensible Switch Port and Network Adapter States.

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 ruft die SetNetBufferListSource-Funktion auf, um den Quellportbezeichner und den Netzwerkadapterindex in der NET_BUFFER_LIST Struktur eines Pakets festzulegen. Die Erweiterung übernimmt dies für die folgenden Pakettypen:

Ein neues Paket, das die Erweiterung für Sende- oder Empfangsvorgänge zugewiesen hat.
Hinweis Bevor die Erweiterung SetNetBufferListSource für ein zugeordnetes Paket aufruft, muss sie AllocateNetBufferListForwardingContext aufrufen.
Ein dupliziertes Paket, das die Erweiterung aus einem ursprünglich gefilterten Paket geklont hatte. Die Erweiterung dupliziert ein Paket, indem NdisAllocateCloneNetBufferList aufgerufen wird.

In beiden Fällen ist der Quellportbezeichner für ein neues oder dupliziertes Paket auf NDIS_SWITCH_DEFAULT_PORT_ID und der Index des Quellnetzwerkadapters auf NDIS_SWITCH_DEFAULT_NIC_INDEX festgelegt. Die Erweiterung ruft die SetNetBufferListSource-Funktion auf, um den Quellportbezeichner und den Netzwerkadapterindex in der NET_BUFFER_LIST Struktur eines Pakets zu ändern.

Beispielsweise ist ein Paket mit dem Quellportbezeichner NDIS_SWITCH_DEFAULT_PORT_ID vertrauenswürdig und umgeht viele erweiterbare Switchportrichtlinien. Diese Richtlinien umfassen Zugriffssteuerungslisten (AcLs) und Quality of Service (QoS). Wenn die Erweiterung einen nicht standardmäßigen Quellport für das Paket angibt, können die Richtlinien für diesen Port auf das Paket angewendet werden.

Hinweis Da Pakete mit einem Quellportbezeichner von NDIS_SWITCH_DEFAULT_PORT_ID vertrauenswürdig sind, muss die Erweiterung diesen Quellportbezeichner sehr sorgfältig verwenden, wenn sie Paketdatenverkehr entspringt. Weitere Informationen zur empfohlenen Verwendung des NDIS_SWITCH_DEFAULT_PORT_ID für Quellports finden Sie unter Verwalten von Hyper-V Extensible Switch-Quellportdaten.

Weitere Informationen zu Sende- und Empfangsvorgängen von Paketen finden Sie unter Filter Module Send and Receive Operations.

Anforderungen

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

Weitere Informationen

AllocateNetBufferListForwardingContext

NET_BUFFER

NET_BUFFER_LIST

NdisAllocateCloneNetBufferList

NdisFGetOptionalSwitchHandler

Freigeben über