NDIS_RSC_NBL_INFO unione (ndis/nblrsc.h)

Articolo
02/26/2024

L'unione NDIS_RSC_NBL_INFO specifica la ricezione di informazioni sul contatore del segmento di raggruppamento (RSC) associate a una struttura di NET_BUFFER_LIST.

Sintassi

typedef union _NDIS_RSC_NBL_INFO {
  struct {
    USHORT CoalescedSegCount;
    USHORT DupAckCount;
  } Info;
  PVOID  Value;
} NDIS_RSC_NBL_INFO, *PNDIS_RSC_NBL_INFO;

Members

Info

Membro dell'unione contenuta in NDIS_RSC_NBL_INFO. I driver usano Info per accedere alle informazioni rsc. Le informazioni sono una struttura con i membri seguenti:

Info.CoalescedSegCount

Numero di segmenti uniti nella struttura NET_BUFFER_LIST . Per i pacchetti non RSC questo membro deve essere impostato su zero. I driver possono accedere a questo membro con la macro NET_BUFFER_LIST_COALESCED_SEG_COUNT .

Nota Le informazioni RscTcpTimestampDelta e il membro DupAckCount devono essere non zero solo se CoalescedSegCount non è zero. Per altre informazioni su RscTcpTimestampDelta, vedere la sezione osservazioni.

Info.DupAckCount

Numero di SDK duplicati rilevati durante la creazione della struttura di NET_BUFFER_LIST . DupAckCount deve essere diverso da zero solo se CoalescedSegCount non è zero. I driver possono accedere a questo membro con la macro NET_BUFFER_LIST_DUP_ACK_COUNT .

Value

Membro dell'unione contenuta in NDIS_RSC_NBL_INFO. I driver usano Value per accedere alle informazioni RSC come singolo PVOID.

Commenti

Per accedere alle informazioni sul contatore del segmento di coalescing (RSC) associate a una struttura NET_BUFFER_LIST , un driver NDIS chiama la macro NET_BUFFER_LIST_INFO e specifica il tipo di informazioni TcpRecvSegCoalesceInfo che si trova in un'unione NDIS_RSC_NBL_INFO .

Per accedere alle informazioni sul timestamp RSC associate a una struttura NET_BUFFER_LIST , un driver NDIS chiama la macro NET_BUFFER_LIST_INFO e specifica il tipo di informazioni RscTcpTimestampDelta che è un singolo valore ULONG .

Nota Le informazioni RscTcpTimestampDelta e il membro DupAckCount di NDIS_RSC_NBL_INFO devono essere non zero solo se CoalescedSegCount non è zero.

Le informazioni RscTcpTimestampDelta potrebbero essere impostate per i segmenti di carbone che usano l'opzione timestamp TCP. Le informazioni rscTcpTimestampDelta devono contenere il differenziale tra i valori più recenti del timestamp TCP nella sequenza di segmenti di unione. Il driver miniport può fornire un valore a 16 bit per RscTcpTimestampDelta.

La struttura NET_BUFFER_LIST di una singola unità di unione (SCU) non è diversa dalla struttura di NET_BUFFER_LIST standard indicata nel percorso di ricezione senza RSC. L'SCU è simile a un pacchetto di jumbogram IP proveniente dal filo. Pertanto, ogni SCU indicato deve avere una struttura NET_BUFFER per ogni NET_BUFFER_LIST.

La NET_BUFFER può essere una catena MDL e MDL può avere una dimensione totale che supera la normale unità di trasmissione massima (MTU), ma deve essere limitata dalla lunghezza massima dell'IP legale, vedere la sezione 3.1.

Inoltre, le informazioni aggiuntive NET_BUFFER_LIST possono essere fornite per un'SCU. NDIS esegue la convalida NET_BUFFER_LIST e NET_BUFFER . Lo stack TCPIP host esegue controlli dei pacchetti, tra cui la convalida dell'intestazione IP e TCP.