NDIS_HD_SPLIT_CURRENT_CONFIG struttura (ntddndis.h)

Articolo
03/05/2024

La struttura NDIS_HD_SPLIT_CURRENT_CONFIG fornisce la configurazione di suddivisione dei dati di intestazione corrente di una scheda miniport.

Sintassi

typedef struct _NDIS_HD_SPLIT_CURRENT_CONFIG {
  NDIS_OBJECT_HEADER Header;
  ULONG              HardwareCapabilities;
  ULONG              CurrentCapabilities;
  ULONG              HDSplitFlags;
  ULONG              HDSplitCombineFlags;
  ULONG              BackfillSize;
  ULONG              MaxHeaderSize;
} NDIS_HD_SPLIT_CURRENT_CONFIG, *PNDIS_HD_SPLIT_CURRENT_CONFIG;

Members

Header

Struttura NDIS_OBJECT_HEADER per la struttura NDIS_HD_SPLIT_CURRENT_CONFIG. Il driver imposta il membro Type della struttura che Header specifica per NDIS_OBJECT_TYPE_DEFAULT, il membro Revision su NDIS_HD_SPLIT_CURRENT_CONFIG_REVISION_1 e il membro Size su NDIS_SIZEOF_HD_SPLIT_CURRENT_CONFIG_REVISION_1.

HardwareCapabilities

Le funzionalità hardware di suddivisione dei dati dell'intestazione supportate dall'adattatore miniport. Queste funzionalità devono includere funzionalità attualmente disabilitate dalle impostazioni del file INF o tramite la pagina Proprietà avanzate . Il valore di HardwareCapabilities è un OR bit per bit dei flag seguenti:

NDIS_HD_SPLIT_CAPS_SUPPORTS_HEADER_DATA_SPLIT

L'adattatore miniport può suddividere l'intestazione e i dati in elenchi di descrittori di memoria separati (MDLs) che soddisfano i requisiti per il supporto della suddivisione dei dati delle intestazioni.

NDIS_HD_SPLIT_CAPS_SUPPORTS_IPV4_OPTIONS

L'adattatore miniport può dividere i frame Ethernet IPv4 che includono opzioni IPv4. L'adattatore miniport può supportare la suddivisione di alcune opzioni IPv4 mentre non divide altri.

Nota La scheda di interfaccia di rete non deve dividere i frame IPv4 che contengono opzioni IPv4 non supportate. Se un frame IPv4 è diviso, la parte dell'intestazione del frame di divisione deve contenere l'intera intestazione IPv4 e tutte le opzioni IPv4 presenti.

NDIS_HD_SPLIT_CAPS_SUPPORTS_IPV6_EXTENSION_HEADERS

L'adattatore miniport può dividere i frame Ethernet IPv6 che includono intestazioni di estensione IPv6. L'adattatore miniport può supportare alcune intestazioni di estensione IPv6 mentre non supportano altri.

Nota La scheda di interfaccia di rete non deve dividere i frame IPv6 che contengono intestazioni di estensione IPv6 non supportate. Se un frame IPv6 è diviso, la parte dell'intestazione del frame di divisione deve contenere l'intera intestazione IPv6 e tutte le intestazioni di estensione IPv6 presenti.

NDIS_HD_SPLIT_CAPS_SUPPORTS_TCP_OPTIONS

L'adattatore miniport può dividere i frame TCP con altre opzioni TCP oltre all'opzione timestamp. L'adattatore miniport può supportare alcune opzioni TCP e non supportare altri.

Nota Se l'unica opzione TCP in un frame è l'opzione timestamp, il provider di divisione dati deve essere in grado di suddividere il frame.

Nota Se un'intestazione TCP contiene un'opzione TCP non supportata, la scheda di interfaccia di rete deve dividere il frame all'inizio dell'intestazione TCP o non deve dividere il frame.

CurrentCapabilities

Funzionalità di suddivisione dei dati di intestazione correnti supportate dall'adattatore miniport. Il driver miniport usa gli stessi flag definiti per il membro HardwareCapabilities . In questo caso, i flag sono impostati per indicare le funzionalità correnti che dipendono dalle impostazioni di configurazione correnti.

HDSplitFlags

Set di flag che segnalano lo stato di suddivisione dei dati di intestazione per una scheda miniport. NDIS imposta questo membro con un or bit per bit dei flag seguenti:

NDIS_HD_SPLIT_ENABLE_HEADER_DATA_SPLIT

Il driver miniport ha abilitato la suddivisione dei dati di intestazione nell'hardware. In caso contrario, la suddivisione dei dati di intestazione è disabilitata.

HDSplitCombineFlags

Set di flag che specificano le impostazioni di suddivisione dei dati di intestazione correnti di un adattatore miniport. Il valore di HDSplitCombineFlags può essere un OR bit per bit dei flag seguenti:

NDIS_HD_SPLIT_COMBINE_ALL_HEADERS

L'adattatore miniport combina fotogrammi di divisione. Se la suddivisione dei dati di intestazione è abilitata nell'hardware, il driver miniport deve combinare l'intestazione e i dati prima di indicare il frame a NDIS.

BackfillSize

Dimensioni del riempimento di backfill, in byte, che il driver miniport usa per la parte dati di un frame di divisione.

MaxHeaderSize

Dimensioni massime, in byte, che il driver miniport usa per la parte di intestazione di un frame di divisione.

Nota Se la lunghezza di un'intestazione supera MaxHeaderSize a causa della presenza di opzioni IPv4, intestazioni IPsec o intestazioni di estensione IPv6, il frame non deve essere suddiviso. Se un'intestazione che include un'intestazione TCP o UDP supera MaxHeaderSize a causa della presenza di intestazione TCP, opzioni TCP o intestazione UDP, la scheda di interfaccia di rete deve dividere il frame all'inizio dell'intestazione del protocollo di livello superiore o non deve dividere il frame.

Commenti

La struttura NDIS_HD_SPLIT_CURRENT_CONFIG viene usata nell'oggetto OID_GEN_HD_SPLIT_CURRENT_CONFIG Richiesta di query OID per ottenere la configurazione di suddivisione dei dati di intestazione corrente di una scheda miniport.

Requisiti

Requisito	Valore
Client minimo supportato	Supportato in NDIS 6.1 e versioni successive.
Intestazione	ntddndis.h (include Ndis.h)

Vedi anche

NDIS_OBJECT_HEADER

NdisMSetMiniportAttributes

OID_GEN_HD_SPLIT_CURRENT_CONFIG

Condividi tramite