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

Artículo
08/07/2023

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

NDIS llama a la función ProtocolQueryOffloadComplete de un controlador de protocolo o a un controlador intermedio para completar una operación de descarga de consulta que el controlador inició anteriormente mediante una llamada a la función NdisQueryOffload .

Sintaxis

QUERY_OFFLOAD_COMPLETE_HANDLER QueryOffloadCompleteHandler;

void QueryOffloadCompleteHandler(
  [in] IN NDIS_HANDLE ProtocolBindingContext,
  [in] IN PNDIS_PROTOCOL_OFFLOAD_BLOCK_LIST OffloadBlockList
)
{...}

Parámetros

[in] ProtocolBindingContext

Identificador de un área de contexto asignada por el controlador de protocolo. El controlador mantiene la información de contexto por enlace en este área de contexto. El controlador proporcionó este identificador a NDIS cuando el controlador llamó a la función NdisOpenAdapterEx .

[in] OffloadBlockList

Puntero a un NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST estructura que puede ser una estructura independiente o la raíz de una lista vinculada de estas estructuras. Estas estructuras identifican el estado consultado o que se intentó consultar.

Valor devuelto

None

Observaciones

En respuesta a la llamada del controlador intermedio o del destino de descarga subyacente a La función NdisMQueryOffloadStateComplete , NDIS llama a la función ProtocolQueryOffloadComplete del controlador de protocolo excesivo o del controlador intermedio.

Un controlador intermedio debe propagar la finalización de la operación de descarga de consulta al controlador anterior mediante una llamada a NdisMQueryOffloadStateComplete. Para obtener más información, vea Propagación de la finalización de una operación de State-Manipulation.

Desde la estructura NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST que se pasó a su función ProtocolQueryOffloadComplete , el controlador intermedio construye un NDIS_MINIPORT_OFFLOAD_BLOCK_LIST estructura. Para obtener más información, consulte Reutilización de una estructura de NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST. Al llamar a la función NdisMQueryOffloadStateComplete , el controlador intermedio pasa un puntero (el parámetro OffloadBlockList ) a esta estructura de NDIS_MINIPORT_OFFLOAD_BLOCK_LIST recién construida.