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

Artículo
08/07/2023

La función GrowNetBufferListDestinations agrega espacio para puertos de destino de conmutador extensibles 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 está asociada la extensión de conmutador extensible de 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 mediante una llamada a la función AllocateNetBufferListForwardingContext . Para obtener más información sobre el contexto de reenvío de conmutador extensible, consulte Contexto de reenvío de conmutador extensible de Hyper-V.

[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 de NDIS_SWITCH_FORWARDING_DESTINATION_ARRAY . Esta estructura especifica los puertos de destino de conmutador extensible del paquete.

Valor devuelto

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

Comentarios

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 , el espacio para puertos de destino adicionales solo se agrega a la primera estructura de NET_BUFFER_LIST de la lista.

Requisitos

Requisito	Value
Cliente mínimo compatible	Se admite en NDIS 6.30 y versiones posteriores.
Plataforma de destino	Escritorio
Encabezado	ndis.h (incluya Ndis.h)
IRQL	<= DISPATCH_LEVEL