NDIS_SWITCH_GROW_NET_BUFFER_LIST_DESTINATIONS fonction de rappel (ndis.h)

Article
02/29/2024

La fonction GrowNetBufferListDestinations ajoute de l’espace pour les ports de destination de commutateur extensible Hyper-V supplémentaires à 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é par le biais du paramètre NdisSwitchContext .

NetBufferList

Pointeur vers une liste liée de structures NET_BUFFER_LIST .

Note 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 Contexte de transfert de commutateur extensible Hyper-V.

[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 du commutateur extensible du paquet.

Valeur retournée

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 la fonction GrowNetBufferListDestinations 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.

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Pris en charge dans NDIS 6.30 et versions ultérieures.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	ndis.h (inclure Ndis.h)
IRQL	<= DISPATCH_LEVEL