NDIS_SWITCH_GROW_NET_BUFFER_LIST_DESTINATIONS Rückruffunktion (ndis.h)

Artikel
02/29/2024

Die Funktion GrowNetBufferListDestinations fügt einem Paket, das durch eine NET_BUFFER_LIST-Struktur angegeben wird, Platz für zusätzliche erweiterbare Hyper-V-Switchzielports hinzu.

Syntax

NDIS_SWITCH_GROW_NET_BUFFER_LIST_DESTINATIONS NdisSwitchGrowNetBufferListDestinations;

NDIS_STATUS NdisSwitchGrowNetBufferListDestinations(
  [in]  NDIS_SWITCH_CONTEXT NdisSwitchContext,
        PNET_BUFFER_LIST NetBufferList,
  [in]  UINT32 NumberOfNewDestinations,
  [out] PNDIS_SWITCH_FORWARDING_DESTINATION_ARRAY *Destinations
)
{...}

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.

NetBufferList

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

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. Weitere Informationen zum Weiterleitungskontext für erweiterbare Switches finden Sie unter Hyper-V Extensible Switch Forwarding Context.

[in] NumberOfNewDestinations

Ein UINT32-Wert, der die Anzahl der neuen Zielports angibt, die für das Paket hinzugefügt werden sollen.

[out] Destinations

Ein Zeiger auf eine NDIS_SWITCH_FORWARDING_DESTINATION_ARRAY-Struktur . Diese Struktur gibt die erweiterbaren Switchzielports des Pakets an.

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 Funktion GrowNetBufferListDestinations auf, um Speicherplatz für Zielports für ein Paket hinzuzufügen. Portziele werden über eine NDIS_SWITCH_FORWARDING_DESTINATION_ARRAY-Struktur angegeben.

Weitere Informationen zum Hinzufügen von Zielports zu einem Paket finden Sie unter Hinzufügen von Zielportdaten für den erweiterbaren Switch zu einem Paket.

Hinweis Wenn der NetBufferList-Parameter einen Zeiger auf eine verknüpfte Liste mehrerer NET_BUFFER_LIST-Strukturen enthält, wird nur der ersten NET_BUFFER_LIST-Struktur in der Liste Speicherplatz für zusätzliche Zielports hinzugefügt.

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