W_QUERY_OFFLOAD_HANDLER función de devolución de llamada (ndischimney.h)
[La característica de descarga de chimenea TCP está en desuso y no se debe usar.]
La función MiniportQueryOffload consulta objetos de estado de chimenea TCP descargados anteriormente.
Sintaxis
W_QUERY_OFFLOAD_HANDLER WQueryOffloadHandler;
void WQueryOffloadHandler(
[in] IN NDIS_HANDLE MiniportAdapterContext,
[in, out] IN OUT 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, out] 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 estado descargado que se está consultando.
Valor devuelto
None
Observaciones
La función MiniportQueryOffload puede consultar cualquier estado de chimenea TCP que se haya descargado en el destino de descarga.
La función MiniportQueryOffload almacena el puntero OffloadBlockList y, a continuación, devuelve. El destino de descarga siempre completa la operación de consulta de forma asincrónica llamando a . Función NdisMQueryOffloadStateComplete . El puntero OffloadBlockList apunta a un NDIS_MINIPORT_OFFLOAD_BLOCK_LIST estructura que puede ser una estructura independiente o el nodo raíz en un árbol de estado de descarga. El árbol de estado es válido hasta que el destino de descarga llama a la función NdisMQueryOffloadStateComplete .
Después de volver de la función MiniportQueryOffload , el controlador de miniporta rellena la estructura de estado de descarga asociada a cada estructura de NDIS_MINIPORT_OFFLOAD_BLOCK_LIST en el árbol de estado al que apunta el puntero OffloadBlockList . Para cada una de estas estructuras de estado de descarga, el controlador de minipuerto escribe el valor actual de cada variable de la estructura.
Antes de llamar a la función NdisMQueryOffloadStateComplete , el destino de descarga debe escribir cualquiera de los siguientes valores de NDIS_STATUS en el miembro Status de cada estructura de NDIS_MINIPORT_OFFLOAD_BLOCK_LIST en el árbol de estado:
-
NDIS_STATUS_SUCCESS
El destino de descarga ha consultado correctamente los objetos de estado.
-
NDIS_STATUS_FAILURE
La operación de consulta no se realizó correctamente. La pila de hosts finalizará los objetos de estado que no se pudieron consultar.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | ndischimney.h (incluya Ndischimney.h) |
| IRQL | Cualquier nivel |