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

  • Artículo

La función FreeNetBufferListForwardingContext libera recursos en el contexto de reenvío extensible de conmutadores fuera de banda (OOB) de una estructura NET_BUFFER_LIST . Estos datos se usaron para las operaciones de envío o recepción en un conmutador extensible de Hyper-V y se asignaron anteriormente mediante una llamada a la función AllocateNetBufferListForwardingContext .

Sintaxis

NDIS_SWITCH_FREE_NET_BUFFER_LIST_FORWARDING_CONTEXT NdisSwitchFreeNetBufferListForwardingContext;

void NdisSwitchFreeNetBufferListForwardingContext(
  [in]      NDIS_SWITCH_CONTEXT NdisSwitchContext,
  [in, out] PNET_BUFFER_LIST NetBufferList
)
{...}

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 .

[in, out] 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 que se asignó anteriormente mediante una llamada a la función AllocateNetBufferListForwardingContext .
 

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 puede originar operaciones de envío de paquetes dentro de la ruta de acceso de datos del conmutador extensible. Por ejemplo, la extensión puede enviar paquetes a cualquier puerto del conmutador extensible. Para obtener más información sobre esta ruta de acceso de datos, consulte Ruta de acceso de datos de conmutador extensible de Hyper-V.

Si la extensión de conmutador extensible origina una operación de envío de paquetes, la extensión debe llamar a la función AllocateNetBufferListForwardingContext . Esta función asigna e inicializa el contexto de reenvío para la estructura de NET_BUFFER_LIST especificada. Para obtener más información sobre este contexto, vea Contexto de reenvío de conmutador extensible de Hyper-V.

Una vez completada la operación de envío, la extensión debe llamar a la función FreeNetBufferListForwardingContext para desasignar el contexto de reenvío.

Nota La extensión debe llamar a la función FreeNetBufferListForwardingContext cuando se completa la operación de envío. La extensión debe hacerlo independientemente de si agrega la estructura de NET_BUFFER_LIST del paquete a una lista de búsqueda o llama a NdisFreeNetBufferList para devolver la estructura a un grupo.
 
Para obtener más información sobre cómo originar operaciones de envío, vea Filtrar operaciones de envío y recepción del módulo.
Nota Si el parámetro NetBufferList contiene un puntero a una lista vinculada de varias estructuras de NET_BUFFER_LIST , solo la primera estructura NET_BUFFER_LIST de la lista tiene su contexto de reenvío desasignado.
 

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

NET_BUFFER_LIST

NdisFGetOptionalSwitchHandlers

NdisFreeNetBufferList