NDIS_SWITCH_ADD_NET_BUFFER_LIST_DESTINATION función de devolución de llamada (ndis.h)

Artículo
02/07/2025

La función addNetBufferListDestination agrega un único puerto de destino para un paquete especificado por una estructura de NET_BUFFER_LIST.

Sintaxis

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

Parámetros

[in] NdisSwitchContext

Valor NDIS_SWITCH_CONTEXT que contiene el identificador del módulo de conmutador extensible al que se adjunta la extensión de conmutador extensible Hyper-V. Cuando la extensión llama a NdisFGetOptionalSwitchHandlers, este identificador se devuelve a través del parámetro NdisSwitchContext.

[in, out] NetBufferList

Puntero a una estructura de NET_BUFFER_LIST para un paquete.

Nota Esta estructura debe contener un contexto de reenvío de conmutador extensible. Si la extensión ha creado o clonado el paquete, debe haber asignado previamente esta estructura llamando a la función AllocateNetBufferListForwardingContext.

[in] Destination

Puntero a una estructura NDIS_SWITCH_PORT_DESTINATION. Esta estructura especifica el puerto de conmutador extensible de destino al que se reenviará el paquete.

Valor devuelto

Si la llamada se realiza correctamente, la función devuelve NDIS_STATUS_SUCCESS. De lo contrario, devuelve un NDIS_STATUS_código de error xxx definido en Ndis.h.

Observaciones

La extensión de conmutador extensible de reenvío llama a addNetBufferListDestination para definir un único puerto de destino de conmutador extensible para un paquete. La extensión especifica este puerto inicializando una estructura NDIS_SWITCH_PORT_DESTINATION. La extensión establece el parámetro Destination en un puntero a esta estructura. Para obtener más información sobre cómo especificar un puerto de destino de conmutador extensible, vea Managing Hyper-V Extensible Switch Destination Port Data.

Nota Por motivos de rendimiento, la extensión no debe llamar a AddNetBufferListDestination paquetes con varios puertos de destino.

La extensión debe seguir estas instrucciones antes de llamar a AddNetBufferListDestination:

Solo las extensiones de reenvío pueden llamar a addNetBufferListDestination para agregar un puerto de destino para un paquete. Para obtener más información sobre este tipo de extensión, vea Extensiones de reenvío.
Si la extensión de reenvío se origina en un paquete con un puerto de destino, la extensión primero debe llamar a la función AllocateNetBufferListForwardingContext. Esta función asigna el contexto de reenvío extensible del conmutador para el paquete. Estos datos contienen los puertos de origen y destino del conmutador extensible dentro de la información fuera de banda (OOB) del paquete.
Para obtener más información sobre este contexto, vea Hyper-V contexto de reenvío extensible de conmutadores.
Una vez que la extensión modifica la información del puerto de destino en la estructura de NDIS_SWITCH_PORT_DESTINATION, llama a AddNetBufferListDestination para confirmar los cambios en la estructura NET_BUFFER_LIST del paquete.
Nota Por motivos de rendimiento, la extensión no debe llamar a la función UpdateNetBufferListDestinations para confirmar los cambios del paquete.

Nota Después de que la extensión de reenvío confirme los cambios de los puertos de destino en el contexto de reenvío, no se pueden quitar los puertos de destino y solo se puede cambiar el miembro IsExcluded de la estructura NDIS_SWITCH_PORT_DESTINATION de un puerto de destino. Para obtener más información, vea excluir la entrega de paquetes a puertos de destino de conmutador extensible.

Requisitos

Requisito	Valor
cliente mínimo admitido	Compatible con NDIS 6.30 y versiones posteriores.
de la plataforma de destino de	Escritorio
encabezado de	ndis.h (incluya Ndis.h)
irQL	<= DISPATCH_LEVEL