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

La función FreeNetBufferListForwardingCon text libera recursos en el contexto de reenvío extensible de conmutador fuera de banda (OOB) de una estructura de 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 asignó anteriormente mediante una llamada a la función de 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 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 lista vinculada de estructuras de NET_BUFFER_LIST.

Nota Esta estructura debe contener un contexto de reenvío de conmutador extensible asignado anteriormente mediante una llamada a la función de AllocateNetBufferListForwardingContext.

 

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 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 Hyper-V ruta de acceso de datos de conmutador extensible.

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 Hyper-V contexto de reenvío extensible de conmutadores.

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

Nota La extensión debe llamar a la función freeNetBufferListForwardingContext cuando se complete la operación de envío. La extensión debe hacerlo independientemente de si agrega la estructura NET_BUFFER_LIST del paquete a una lista de aspecto o llama a NdisFreeNetBufferList para devolver la estructura a un grupo.

 

Para obtener más información sobre cómo originar las operaciones de envío, consulte Filtrar módulo enviar y recibir operaciones.

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	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

Consulte también

AllocateNetBufferListForwardingContext

NET_BUFFER_LIST

NdisFGetOptionalSwitchHandlers

NdisFreeNetBufferList