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

Artículo
02/07/2025

La función GrowNetBufferListDestinations agrega espacio para puertos de destino de conmutador extensible de Hyper-V adicionales a un paquete especificado por una estructura de NET_BUFFER_LIST.

Sintaxis

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

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.

NetBufferList

Puntero a una lista vinculada de estructuras de NET_BUFFER_LIST.

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. Para obtener más información sobre el contexto de reenvío extensible de conmutadores, vea Hyper-V contexto de reenvío extensible de conmutadores.

[in] NumberOfNewDestinations

Valor UINT32 que especifica el número de puertos de destino nuevos que se van a agregar para el paquete.

[out] Destinations

Puntero a una estructura NDIS_SWITCH_FORWARDING_DESTINATION_ARRAY. Esta estructura especifica los puertos de destino del conmutador extensible del 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 llama a la función GrowNetBufferListDestinations para agregar espacio para los puertos de destino de un paquete. Los destinos de puerto se especifican a través de una estructura de NDIS_SWITCH_FORWARDING_DESTINATION_ARRAY.

Para obtener más información sobre cómo agregar puertos de destino a un paquete, vea Agregar datos de puerto de destino de conmutador extensible a un paquete.

Nota Si el parámetro NetBufferList contiene un puntero a una lista vinculada de varias estructuras de NET_BUFFER_LIST, solo se agrega espacio para puertos de destino adicionales a la primera estructura de NET_BUFFER_LIST de la lista.

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