W_INVALIDATE_OFFLOAD_HANDLER función de devolución de llamada (ndischimney.h)

  • Artículo

[La característica de descarga de chimenea TCP está en desuso y no se debe usar.]

La función MiniportInvalidateOffload invalida los objetos de estado de chimenea TCP descargados anteriormente.

Sintaxis

W_INVALIDATE_OFFLOAD_HANDLER WInvalidateOffloadHandler;

void WInvalidateOffloadHandler(
  [in] IN NDIS_HANDLE MiniportAdapterContext,
  [in] IN PNDIS_MINIPORT_OFFLOAD_BLOCK_LIST OffloadBlockList
)
{...}

Parámetros

[in] MiniportAdapterContext

Identificador de un área de contexto asignada de destino de descarga en la que el destino de descarga mantiene información de estado sobre esta instancia del adaptador. El destino de descarga proporcionó este identificador a NDIS cuando llamó NdisMSetMiniportAttributes de su Función MiniportInitializeEx .

[in] OffloadBlockList

Puntero a un NDIS_MINIPORT_OFFLOAD_BLOCK_LIST estructura, que puede ser la raíz de una lista vinculada de estas estructuras. Estas estructuras identifican el objeto de estado descargado que se está invalidando.

Valor devuelto

None

Observaciones

La función MiniportInvalidateOffload almacena el puntero OffloadBlockList y, a continuación, devuelve. El destino de descarga siempre completa la operación de invalidar de forma asincrónica mediante una llamada a . NdisMInvalidateOffloadComplete.

El árbol pasado a la función MiniportInvalidateOffload solo contiene estructuras NDIS_MINIPORT_OFFLOAD_BLOCK_LIST. El árbol no contiene ninguna estructura de estado de descarga. Es decir, no hay estas estructuras siguiendo las estructuras de NDIS_MINIPORT_OFFLOAD_BLOCK_LIST en la memoria.

Las estructuras NDIS_MINIPORT_OFFLOAD_BLOCK_LIST del árbol indican que se va a invalidar el objeto de estado. Un miembro *MiniportOffloadContext distinto de NULL apunta a una ubicación de memoria que contiene un valor PVOID proporcionado por el destino de descarga cuando se descargó el objeto de estado. Para obtener más información, vea Almacenar y hacer referencia al estado descargado. Este valor PVOID hace referencia al contexto de descarga de miniporte en el que el destino de descarga almacena el objeto de estado que se va a invalidar.

Para obtener información sobre el tratamiento de un destino de descarga de objetos de estado invalidados, vea Tratamiento de objetos de estado invalidados.

Finalmente, la pila de hosts finalizará la descarga del objeto de estado invalidado. Sin embargo, hasta ese momento, el destino de descarga posee el objeto de estado invalidado. El destino de descarga no debe liberar los recursos para el objeto de estado invalidado hasta que la pila host haya terminado la descarga de ese objeto de estado. El destino de descarga no debe usar el objeto de estado invalidado ni ninguna conexión TCP que dependa de ese objeto de estado para enviar datos.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado ndischimney.h (incluya Ndischimney.h)
IRQL Cualquier nivel

Consulte también

MiniportInitializeEx

NDIS_MINIPORT_OFFLOAD_BLOCK_LIST NdisMInvalidateOffloadComplete

NdisMSetMiniportAttributes