Leer en inglés

Compartir a través de


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

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

Consulte también

AllocateNetBufferListForwardingContext

NDIS_SWITCH_FORWARDING_DESTINATION_ARRAY

NDIS_SWITCH_PORT_DESTINATION

NET_BUFFER

NET_BUFFER_LIST

NdisFGetOptionalSwitchHandlers

UpdateNetBufferListDestinations