NDIS_SWITCH_GROW_NET_BUFFER_LIST_DESTINATIONS fonction de rappel (ndis.h)

2025-02-07

La fonction GrowNetBufferListDestinations ajoute de l’espace pour des ports de destination de commutateur extensible supplémentaires Hyper-V à un paquet spécifié par une structure NET_BUFFER_LIST.

Syntaxe

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
)
{...}

Paramètres

[in] NdisSwitchContext

Valeur NDIS_SWITCH_CONTEXT qui contient le handle du module de commutateur extensible auquel l’extension de commutateur extensible Hyper-V est attachée. Lorsque l’extension appelle NdisFGetOptionalSwitchHandlers, ce handle est retourné via le paramètre NdisSwitchContext.

NetBufferList

Pointeur vers une liste liée de structures NET_BUFFER_LIST.

Remarque Cette structure doit contenir un contexte de transfert de commutateur extensible. Si l’extension a créé ou cloné le paquet, elle doit avoir précédemment alloué cette structure en appelant la fonction AllocateNetBufferListForwardingContext. Pour plus d’informations sur le contexte de transfert de commutateur extensible, consultez Hyper-V contexte de transfert de commutateur extensible.

[in] NumberOfNewDestinations

Valeur UINT32 qui spécifie le nombre de nouveaux ports de destination à ajouter pour le paquet.

[out] Destinations

Pointeur vers une structure NDIS_SWITCH_FORWARDING_DESTINATION_ARRAY. Cette structure spécifie les ports de destination de commutateur extensible du paquet.

Valeur de retour

Si l’appel réussit, la fonction retourne NDIS_STATUS_SUCCESS. Sinon, elle retourne un code d’erreur NDIS_STATUS_Xxx défini dans Ndis.h.

Remarques

L’extension de commutateur extensible appelle les GrowNetBufferListDestinations fonction pour ajouter de l’espace pour les ports de destination d’un paquet. Les destinations de port sont spécifiées par le biais d’une structure NDIS_SWITCH_FORWARDING_DESTINATION_ARRAY.

Pour plus d’informations sur l’ajout de ports de destination à un paquet, consultez Ajout de données de port de destination de commutateur extensible à un paquet.

Remarque Si le paramètre NetBufferList contient un pointeur vers une liste liée de plusieurs structures NET_BUFFER_LIST, l’espace pour les ports de destination supplémentaires n’est ajouté qu’à la première structure de NET_BUFFER_LIST dans la liste.

Exigences

Exigence	Valeur
client minimum pris en charge	Prise en charge dans NDIS 6.30 et versions ultérieures.
plateforme cible	Bureau
d’en-tête	ndis.h (include Ndis.h)
IRQL	<= DISPATCH_LEVEL