W_INVALIDATE_OFFLOAD_HANDLER función de devolución de llamada (ndischimney.h)
[La característica de descarga de chimenea TCP está en desuso y no debe usarse].
La función MiniportInvalidateOffload invalida los objetos de estado de chimenea TCP descargados previamente.
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
Ninguno
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 llamando a . NdisMInvalidateOffloadComplete.
El árbol pasado a la función MiniportInvalidateOffload contiene solo estructuras NDIS_MINIPORT_OFFLOAD_BLOCK_LIST. El árbol no contiene ninguna estructura de estado de descarga . Es decir, no hay estructuras de este tipo siguiendo las estructuras NDIS_MINIPORT_OFFLOAD_BLOCK_LIST en memoria.
Las estructuras NDIS_MINIPORT_OFFLOAD_BLOCK_LIST del árbol indican que se va a invalidar el objeto de estado. Un *MiniportOffloadContext no 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 de hosts 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 | Valor |
|---|---|
| de la plataforma de destino de | Windows |
| encabezado de | ndischimney.h (incluya Ndischimney.h) |
| irQL | Cualquier nivel |