NDIS_SWITCH_ADD_NET_BUFFER_LIST_DESTINATION fonction de rappel (ndis.h)

Article
02/07/2025

La fonction AddNetBufferListDestination ajoute un port de destination unique pour un paquet spécifié par une structure NET_BUFFER_LIST.

Syntaxe

NDIS_SWITCH_ADD_NET_BUFFER_LIST_DESTINATION NdisSwitchAddNetBufferListDestination;

NDIS_STATUS NdisSwitchAddNetBufferListDestination(
  [in]      NDIS_SWITCH_CONTEXT NdisSwitchContext,
  [in, out] PNET_BUFFER_LIST NetBufferList,
  [in]      PNDIS_SWITCH_PORT_DESTINATION Destination
)
{...}

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.

[in, out] NetBufferList

Pointeur vers une structure NET_BUFFER_LIST pour un paquet.

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.

[in] Destination

Pointeur vers une structure NDIS_SWITCH_PORT_DESTINATION. Cette structure spécifie le port de commutateur extensible de destination vers lequel le paquet sera transféré.

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 de transfert appelle AddNetBufferListDestination pour définir un port de destination de commutateur extensible unique pour un paquet. L’extension spécifie ce port en initialisant une structure NDIS_SWITCH_PORT_DESTINATION. L’extension définit le paramètre Destination sur un pointeur vers cette structure. Pour plus d’informations sur la façon de spécifier un port de destination de commutateur extensible, consultez Gestion des données de port de destination de commutateur extensible Hyper-V.

Remarque Pour des raisons de performances, l’extension ne doit pas appeler AddNetBufferListDestination paquets avec plusieurs ports de destination.

L’extension doit suivre ces instructions avant d’appeler AddNetBufferListDestination:

Seuls les extensions de transfert peuvent appeler AddNetBufferListDestination pour ajouter un port de destination pour un paquet. Pour plus d’informations sur ce type d’extension, consultez extensions de transfert.
Si l’extension de transfert est à l’origine d’un paquet avec un port de destination, l’extension doit d’abord appeler la fonction AllocateNetBufferListForwardingContext. Cette fonction alloue le contexte de transfert de commutateur extensible pour le paquet. Ces données contiennent les ports de source et de destination extensibles du commutateur dans les informations OOB (out-of-band) du paquet.
Pour plus d’informations sur ce contexte, consultez Hyper-V contexte de transfert de commutateur extensible.
Une fois l’extension modifiée les informations de port de destination dans la structure NDIS_SWITCH_PORT_DESTINATION, elle appelle AddNetBufferListDestination pour valider les modifications apportées à la structure NET_BUFFER_LIST pour le paquet.
Remarque Pour des raisons de performances, l’extension ne doit pas appeler la fonction UpdateNetBufferListDestinations pour valider les modifications du paquet.

Remarque Une fois que l’extension de transfert a validé les modifications apportées aux ports de destination dans le contexte de transfert, les ports de destination ne peuvent pas être supprimés et seuls les IsExcluded membre de la structure NDIS_SWITCH_PORT_DESTINATION d’un port de destination peuvent être modifiés. Pour plus d’informations, consultez Exclusion de la remise de paquets vers des ports de destination de commutateur extensible.

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