NDIS_TCP_LARGE_SEND_OFFLOAD_V1 struttura (ntddndis.h)

Articolo
08/07/2023

La struttura NDIS_TCP_LARGE_SEND_OFFLOAD_V1 fornisce informazioni di offload di trasmissione di grandi dimensioni versione 1 (LSOV1) nella struttura NDIS_OFFLOAD .

Sintassi

typedef struct _NDIS_TCP_LARGE_SEND_OFFLOAD_V1 {
  struct {
    ULONG Encapsulation;
    ULONG MaxOffLoadSize;
    ULONG MinSegmentCount;
    ULONG TcpOptions : 2;
    ULONG IpOptions : 2;
  } IPv4;
} NDIS_TCP_LARGE_SEND_OFFLOAD_V1, *PNDIS_TCP_LARGE_SEND_OFFLOAD_V1;

Members

IPv4

Struttura all'interno di NDIS_TCP_LARGE_SEND_OFFLOAD_V1 che contiene i membri seguenti:

IPv4.Encapsulation

Impostazioni di incapsulamento per IPv4. Per altre informazioni su questo membro, vedere la sezione Osservazioni seguenti.

IPv4.MaxOffLoadSize

Byte massimi di dati utente che il trasporto può passare al driver miniport in un singolo pacchetto. Il trasporto non passerà un pacchetto al driver miniport che contiene più byte di dati utente rispetto a MaxOffLoadSize specifica. Se tale pacchetto deve essere trasmesso, il trasporto stesso segmenta il pacchetto in pacchetti più piccoli.

IPv4.MinSegmentCount

Numero minimo di segmenti che devono essere divisibili da un pacchetto TCP di grandi dimensioni prima che il trasporto possa scaricarlo nell'hardware per la segmentazione. Il trasporto non scarica un pacchetto di grandi dimensioni al driver miniport per la segmentazione a meno che il driver miniport possa creare almeno il numero di segmenti specificati da MinSegmentCount dal pacchetto. Se un pacchetto TCP di grandi dimensioni non soddisfa il requisito minimo di segmento, il trasporto TCP/IP si segmenta in pacchetti più piccoli.

IPv4.TcpOptions

Valore ULONG impostato da un driver miniport per indicare che il driver miniport può segmentare un pacchetto TCP di grandi dimensioni il cui intestazione TCP contiene opzioni TCP o per indicare che questa funzionalità è abilitata o disabilitata. Il trasporto TCP/IP imposta questo valore per abilitare o disabilitare questa funzionalità.

IPv4.IpOptions

Valore ULONG impostato da un driver miniport per indicare che una scheda miniport può segmentare un pacchetto TCP di grandi dimensioni il cui intestazione IP contiene opzioni IP o per indicare che questa funzionalità è abilitata o disabilitata.

Commenti

La struttura NDIS_TCP_LARGE_SEND_OFFLOAD_V1 viene usata nel membro LsoV1 della struttura NDIS_OFFLOAD . NDIS_TCP_LARGE_SEND_OFFLOAD_V1 specifica i servizi correnti o supportati che un adattatore miniport fornisce per segmentare pacchetti TCP di grandi dimensioni in pacchetti più piccoli. NDIS offre anche un offload di trasmissione di grandi dimensioni versione 2 (LSOV2), che è una versione avanzata di LSO. Per altre informazioni su LSOV2, vedere NDIS_TCP_LARGE_SEND_OFFLOAD_V2.

NDIS_OFFLOAD viene usato nell'oggetto struttura NDIS_MINIPORT_ADAPTER_OFFLOAD_ATTRIBUTES , struttura NDIS_BIND_PARAMETERS , NDIS_FILTER_ATTACH_PARAMETERS struttura, OID_TCP_OFFLOAD_CURRENT_CONFIG OID e NDIS_STATUS_TASK_OFFLOAD_CURRENT_CONFIG indicazione dello stato.

Per OID_TCP_OFFLOAD_CURRENT_CONFIG, la struttura NDIS_OFFLOAD specifica le funzionalità di offload attività supportate da una scheda miniport. Se le funzionalità di offload correnti cambiano, un driver miniport segnala le nuove funzionalità in un NDIS_STATUS_TASK_OFFLOAD_CURRENT_CONFIG indicazione dello stato.

Il membro Encapsulation di NDIS_TCP_LARGE_SEND_OFFLOAD_V1 definisce le funzionalità o le impostazioni di incapsulamento LSOV1 per l'adattatore miniport.

In risposta a un OID_TCP_OFFLOAD_CURRENT_CONFIG richiesta di query, NDIS fornisce un OR bit per bit dei flag di incapsulamento, che indicano le impostazioni di incapsulamento supportate, nel membro Encapsulation . I driver Miniport devono fornire incapsulamento Ethernet (NDIS_ENCAPSULATION_IEEE_802_3). Gli altri tipi di incapsulamento sono facoltativi.

Per un oggetto NDIS_STATUS_TASK_OFFLOAD_CURRENT_CONFIG indicazione dello stato, il driver miniport fornisce un OR bit per bit dei flag di incapsulamento, che indicano le funzionalità correnti, nel membro Incapsulation .

I flag seguenti sono definiti per il membro Encapsulation :

NDIS_ENCAPSULATION_NONE o NDIS_ENCAPSULATION_NOT_SUPPORTED
Specifica che non è supportato alcun offload di incapsulamento.

NDIS_ENCAPSULATION_NULL
Specifica l'incapsulamento NULL.

NDIS_ENCAPSULATION_IEEE_802_3
Specifica l'incapsulamento IEEE 802.3.

NDIS_ENCAPSULATION_IEEE_802_3_P_AND_Q
Specifica l'incapsulamento IEEE 802.3p e IEEE 802.3q.

NDIS_ENCAPSULATION_IEEE_802_3_P_AND_Q_IN_OOB
Specifica che le impostazioni di incapsulazione IEEE 802.3p e IEEE 802.3q vengono specificate nel membro NetBufferListInfo di ogni struttura NET_BUFFER_LIST.

NDIS_ENCAPSULATION_IEEE_LLC_SNAP_ROUTED
Specifica l'incapsulamento logico (LLC) per i protocolli indirizzati, come descritto in RFC 1483. Questo flag viene usato anche per indicare l'incapsulamento Ethernet LLC/SNAP.

I valori nei membri TcpOptions e IpOptions di NDIS_TCP_LARGE_SEND_OFFLOAD_V1 specificare il supporto della scheda miniport nell'oggetto OID_TCP_OFFLOAD_CURRENT_CONFIG OID o l'OID NDIS_STATUS_TASK_OFFLOAD_CURRENT_CONFIG indicazione dello stato. Questi membri possono avere uno dei valori seguenti:

NDIS_OFFLOAD_NOT_SUPPORTED
L'adattatore miniport non supporta la funzionalità specificata dal membro.

NDIS_OFFLOAD_SUPPORTED
L'adattatore miniport supporta la funzionalità specificata dal membro