Función NdisMOffloadEventIndicate (ndischimney.h)

Artículo
08/07/2023

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

Un destino de descarga llama a la función NdisMOffloadEventIndicate para indicar varios eventos a la pila de hosts.

Sintaxis

void NdisMOffloadEventIndicate(
  [in] IN NDIS_HANDLE                       NdisMiniportHandle,
  [in] IN PNDIS_MINIPORT_OFFLOAD_BLOCK_LIST OffloadBlockList,
  [in] IN ULONG                             IndicationCode
);

Parámetros

[in] NdisMiniportHandle

Identificador del destino de descarga obtenido en una llamada anterior a NdisMRegisterMiniportDriver.

[in] OffloadBlockList

Puntero a un NDIS_MINIPORT_OFFLOAD_BLOCK_LIST estructura. Esta estructura identifica el objeto de estado descargado en el que se realiza la indicación. Tenga en cuenta que solo hay una estructura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST. No hay una lista vinculada de estas estructuras.

El destino de descarga proporciona un puntero OffloadBlockList válido al realizar una indicación NeighborReachabilityQuery . En este caso, el destino de descarga proporciona un NEIGHBOR_OFFLOAD_STATE_CONST estructura, NEIGHBOR_OFFLOAD_STATE_CACHED estructura y NEIGHBOR_OFFLOAD_STATE_DELEGATED estructura (en ese orden) inmediatamente después de la estructura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST a la que hace referencia el puntero OffloadBlockList .

Un destino de descarga debe inicializar los siguientes miembros de una estructura de NDIS_MINIPORT_OFFLOAD_BLOCK_LIST que pasa a la función NdisMOffloadEventIndicate :

Todos los miembros de la estructura de NDIS_OBJECT_HEADER, incluidos Type, Revision y Size . El destino de descarga debe inicializar Type en NeighborOffloadState.
El puntero NextBlock a un valor distinto de NULL si hay un bloque siguiente; de lo contrario, en NULL.
Puntero DependentBlockList a NULL.
Miembro status que se va a NDIS_STATUS_SUCCESS.

El destino de descarga no tiene que inicializar ningún otro miembro de la estructura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST.

Para todas las indicaciones distintas de la indicación NeighborReachabilityQuery , el destino de descarga proporciona un puntero OffloadBlockList que es NULL.

[in] IndicationCode

El evento que se indica se especifica como uno de los siguientes valores de INDICATE_OFFLOAD_EVENT:

NeighborReachabilityQuery

Indica que una entrada de caché vecina (NCE) se ha vuelto obsoleta. Para obtener más información sobre las CNC, consulte RFC 2461.

NeighborReachabilityInDoubt

Reservado.

Valor devuelto

None

Observaciones

La pila de hosts usa la indicación NeighborReachabilityQuery para detectar la inalcanzabilidad de vecino para IPv4 e IPv6. Para obtener una descripción detallada de esta indicación, vea Making a NeighborReachabilityQuery Indication.