Funzione NdisMOffloadEventIndicate (ndischimney.h)

Articolo
08/07/2023

[La funzionalità di 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 caricato su cui viene effettuata l'indicazione. Si noti che esiste solo una 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 effettua un'indicazione NeighborReachabilityQuery . In questo caso, la destinazione di offload fornisce un NEIGHBOR_OFFLOAD_STATE_CONST struttura, NEIGHBOR_OFFLOAD_STATE_CACHED struttura e una NEIGHBOR_OFFLOAD_STATE_DELEGATED struttura (in tale ordine) immediatamente dopo la struttura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST a cui fa riferimento il puntatore OffloadBlockList .

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

Tutti i membri della struttura NDIS_OBJECT_HEADER, inclusi Type, Revision e Size . La destinazione di offload deve inizializzare il tipo in NeighborOffloadState.
Puntatore NextBlock a un valore non NULL se è presente un blocco successivo; in caso contrario, su 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 offload fornisce un puntatore OffloadBlockListnull.

[in] IndicationCode

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

NeighborReachabilityQuery

Indica che una voce della cache vicina (NCE) è diventata non aggiornata. Per altre informazioni sulle nces, vedere RFC 2461.

NeighborReachabilityInDoubt

Riservato.

Valore restituito

nessuno

Osservazioni

Lo stack host usa l'indicazione NeighborReachabilityQuery per rilevare l'impossibilità vicina per IPv4 e IPv6. Per una descrizione dettagliata di questa indicazione, vedere Creazione di un'indicazione NeighborReachabilityQuery.