Funzione NdisMOffloadEventIndicate (ndischimney.h)

Articolo
02/07/2025

[La funzionalità offload del camino TCP è deprecata e non deve essere usata.]

Una destinazione offload chiama la funzione NdisMOffloadEventIndicate per indicare vari eventi allo stack host.

Sintassi

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

Parametri

[in] NdisMiniportHandle

Handle ottenuto dalla destinazione di offload in una chiamata precedente a NdisMRegisterMiniportDriver.

[in] OffloadBlockList

Puntatore a un oggetto NDIS_MINIPORT_OFFLOAD_BLOCK_LIST struttura. Questa struttura identifica l'oggetto stato offloaded su cui viene effettuata l'indicazione. Si noti che è presente una sola struttura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST. Non esiste un elenco collegato di tali strutture.

La destinazione di offload fornisce un puntatore OffloadBlockList valido quando si crea un'indicazione NeighborReachabilityQuery. In questo caso, la destinazione di offload fornisce un NEIGHBOR_OFFLOAD_STATE_CONST struttura, un NEIGHBOR_OFFLOAD_STATE_CACHED struttura e NEIGHBOR_OFFLOAD_STATE_DELEGATED struttura (in tale ordine) immediatamente dopo la struttura di NDIS_MINIPORT_OFFLOAD_BLOCK_LIST a cui fa riferimento il puntatore offloadBlockList.

Una destinazione offload deve inizializzare i membri seguenti di una struttura di NDIS_MINIPORT_OFFLOAD_BLOCK_LIST che passa alla funzione NdisMOffloadEventIndicate:

Tutti i membri della struttura di NDIS_OBJECT_HEADER, inclusi Type, Revisione Size . La destinazione di offload deve inizializzare Type per NeighborOffloadState.
Puntatore NextBlock a un valoreNULL non se è presente un blocco successivo; in caso contrario, per null.
Puntatore DependentBlockList a NULL.
Membro Status da NDIS_STATUS_SUCCESS.

La destinazione di offload non deve inizializzare altri membri della struttura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST.

Per tutte le indicazioni diverse dall'indicazione NeighborReachabilityQuery, la destinazione di offload fornisce un puntatore offloadBlockListNULL.

[in] IndicationCode

L'evento indicato viene specificato come uno dei valori di INDICATE_OFFLOAD_EVENT seguenti:

NeighborReachabilityQuery

Indica che una voce della cache adiacente (NCE) è diventata obsoleta. Per altre informazioni sui controller di rete, vedere RFC 2461.

NeighborReachabilityInDoubt

Riservato.

Valore restituito

Nessuno

Osservazioni

Lo stack host usa l'indicazione NeighborReachabilityQuery per rilevare l'impossibilità adiacente per IPv4 e IPv6. Per una descrizione dettagliata di questa indicazione, vedere Making a NeighborReachabilityQuery Indication.