Auf Englisch lesen

Freigeben über


NDIS_SWITCH_GROW_NET_BUFFER_LIST_DESTINATIONS Rückruffunktion (ndis.h)

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

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 Hyper-V erweiterbaren Switcherweiterung angefügt ist. Wenn die Erweiterung NdisFGetOptionalSwitchHandlersaufruft, 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 zugewiesen haben. Weitere Informationen zum Kontext der erweiterbaren Switchweiterleitung 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 Switch-Zielports 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.

Bemerkungen

Die erweiterbare Switcherweiterung ruft die GrowNetBufferListDestinations- Funktion 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 Extensible Switch Destination Port Data zu einem Paket-.

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

Anforderungen

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

Siehe auch

AllocateNetBufferListForwardingContext-

NDIS_SWITCH_FORWARDING_DESTINATION_ARRAY

NDIS_SWITCH_PORT_DESTINATION

NET_BUFFER

NET_BUFFER_LIST

NdisFGetOptionalSwitchHandlers

UpdateNetBufferListDestinations-