struttura IP_OFFLOAD_STATS (ndischimney.h)

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

La struttura IP_OFFLOAD_STATS contiene statistiche fornite da una destinazione di offload in risposta a una query di OID_IP4_OFFLOAD_STATS o OID_IP6_OFFLOAD_STATS.

Sintassi

typedef struct _IP_OFFLOAD_STATS {
  ULONG64 InReceives;
  ULONG64 InOctets;
  ULONG64 InDelivers;
  ULONG64 OutRequests;
  ULONG64 OutOctets;
  ULONG   InHeaderErrors;
  ULONG   InTruncatedPackets;
  ULONG   InDiscards;
  ULONG   OutDiscards;
  ULONG   OutNoRoutes;
} IP_OFFLOAD_STATS, *PIP_OFFLOAD_STATS;

Members

InReceives

Numero totale di datagrammi IP di input ricevuti dall'interfaccia su connessioni TCP offloaded, inclusi i datagrammi IP ricevuti in errore. Vedere "ipInReceives" in RFC 2011.

InOctets

Numero totale di ottetti (byte) nei datagrammi IP di input ricevuti dall'interfaccia su connessioni TCP offloaded. Gli ottetti di datagrammi conteggiati in InReceives devono essere conteggiati qui. InOctets deve includere il numero di byte nell'intestazione IP e nel payload.

InDelivers

Numero di datagrammi IP di input recapitati correttamente alle connessioni TCP offloaded. Vedere "ipInDelivers" in RFC 2011.

OutRequests

Numero di datagrammi IP forniti dalla destinazione di offload al relativo livello IP nelle richieste di trasmissione su connessioni TCP scaricate. Vedere "ipOutRequests" in RFC 2011.

OutOctets

Numero totale di ottetti (byte) nei datagrammi IP forniti dalla destinazione di offload al relativo livello IP nelle richieste di trasmissione su connessioni TCP scaricate. Gli ottetti dei datagrammi conteggiati in OutRequests devono essere conteggiati qui. Gli outOctets devono includere il numero di byte nell'intestazione IP e nel payload.

InHeaderErrors

Numero di datagrammi IP di input ricevuti in connessioni TCP offload eliminate a causa di errori nelle intestazioni IP. Tali errori includono checksum non valido, mancata corrispondenza del numero di versione, altri errori di formato, time-to-live superati e errori individuati nelle opzioni IPv6 di elaborazione se la destinazione di offload supporta tali opzioni. Una destinazione offload non elabora le opzioni IPv4. Questo conteggio non include errori risultanti da indirizzi di destinazione non validi. Vedere "ipInHdrErrors" in RFC 2011.

InTruncatedPackets

Numero di datagrammi IP di input eliminati perché il frame di datagrammi non ha portato dati sufficienti. InTruncatedPackets deve essere incrementato solo se il frame conteneva un'intestazione valida, ma era altrimenti più breve del necessario. I frame troppo brevi per contenere un'intestazione valida devono essere conteggiati come InHeaderErrors .

InDiscards

Numero di datagrammi IP di input ricevuti in connessioni TCP offload che non contengono nulla per impedire l'ulteriore elaborazione, ma che sono state eliminate per motivi di runtime, ad esempio la mancanza di memoria disponibile o altre risorse. Vedere "ipInDiscards" in RFC 2011.

OutDiscards

Numero di datagrammi IP di output forniti dalla destinazione di offload al relativo livello IP per cui non è stato rilevato alcun problema per impedire la trasmissione, ma che sono stati eliminati per motivi di runtime, ad esempio la mancanza di memoria o altre risorse. Vedere "ipOutDiscards" in RFC 2011.

OutNoRoutes

Il numero di datagrammi IP di output forniti dalla destinazione di offload al livello IP che sono stati eliminati perché non è stata trovata alcuna route (ad esempio un oggetto stato percorso offloaded) per trasmetterle alla destinazione. Vedere "ipOutNoRoutes" in RFC 2011.

Commenti

Le statistiche nella struttura IP_OFFLOAD_STATS riguardano solo i datagrammi IP elaborati dalla destinazione di offload sulle connessioni TCP scaricate. La destinazione di offload non deve includere conteggi per i datagrammi IP in connessioni non offload. Le statistiche riguardano una singola interfaccia di rete.

Se una destinazione di offload ha più interfacce di rete, deve mantenere statistiche di offload IP separate per ogni interfaccia di rete. Se la destinazione di offload supporta le connessioni IPv4 e IPv6 per un'interfaccia di rete, deve mantenere un set di contatori delle statistiche di offload IPv4 e un altro set di contatori delle statistiche di offload IPv6 per tale interfaccia di rete.

Se le funzionalità del camino TCP di una destinazione di offload sono abilitate (vedere NDIS_TASK_OFFLOAD) e se almeno un oggetto stato adiacente è stato scaricato nella destinazione di offload, la destinazione di offload può elaborare un pacchetto ricevuto con un'intestazione IP danneggiata in uno dei due modi seguenti:

  • La destinazione di offload può indicare il pacchetto tramite l'interfaccia non offload chiamando Funzione NdisMIndicateReceiveNetBufferLists . In questo caso, la destinazione di offload non deve incrementare il contatore InHeaderErrors. Questo è l'approccio consigliato.
  • In alternativa, la destinazione di offload può eliminare il pacchetto danneggiato NDIS_TASK_OFFLOAD e incrementare il contatore InHeaderErrors.
Lo stack host integra le statistiche restituite da una destinazione offload con le statistiche che lo stack host gestisce per le connessioni TCP non scaricate.

Si noti che lo stack host fornisce una struttura IP_OFFLOAD_STATS quando si impostano OID_IP4_OFFLOAD_STATS o OID_IP6_OFFLOAD_STATS. In entrambi i casi, tuttavia, la destinazione di offload non deve esaminare i valori nella struttura IP_OFFLOAD_STATS. Al contrario, quando OID_IP4_OFFLOAD_STATS è impostato, la destinazione di offload deve reimpostare tutti i contatori delle statistiche IPv4 per le connessioni TCP offloaded. Quando OID_IP6_OFFLOAD_STATS è impostato, la destinazione di offload deve reimpostare tutti i contatori delle statistiche IPv6 per le connessioni TCP offloaded.

Tutti i contatori che forniscono i valori per il wrapping della struttura IP_OFFLOAD_STATS (riavvio da zero) quando vengono incrementati oltre il numero massimo.

Requisiti

Requisito Valore
Intestazione ndischimney.h (include Ndischimney.h)

Vedi anche

NDIS_TASK_OFFLOAD

NdisMIndicateReceiveNetBufferLists

OID_IP4_OFFLOAD_STATS

OID_IP6_OFFLOAD_STATS