NDIS_HD_SPLIT_CURRENT_CONFIG structure (ntddndis.h)

Article
02/29/2024

La structure NDIS_HD_SPLIT_CURRENT_CONFIG fournit la configuration actuelle de fractionnement d’en-tête-données d’un adaptateur miniport.

Syntaxe

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;

Membres

Header

Structure NDIS_OBJECT_HEADER de la structure NDIS_HD_SPLIT_CURRENT_CONFIG. Le pilote définit le membre Type de la structure que Header spécifie sur NDIS_OBJECT_TYPE_DEFAULT, le membre Revision sur NDIS_HD_SPLIT_CURRENT_CONFIG_REVISION_1 et le membre Size sur NDIS_SIZEOF_HD_SPLIT_CURRENT_CONFIG_REVISION_1.

HardwareCapabilities

Fonctionnalités matérielles de fractionnement d’en-tête et de données prises en charge par l’adaptateur miniport. Ces fonctionnalités doivent inclure des fonctionnalités actuellement désactivées par les paramètres de fichier INF ou via la page Propriétés avancées . La valeur de HardwareCapabilities est au niveau du bit OU des indicateurs suivants :

NDIS_HD_SPLIT_CAPS_SUPPORTS_HEADER_DATA_SPLIT

L’adaptateur miniport peut fractionner l’en-tête et les données en listes de descripteurs mémoire (MDL) distinctes qui répondent aux exigences de prise en charge du fractionnement des données d’en-tête.

NDIS_HD_SPLIT_CAPS_SUPPORTS_IPV4_OPTIONS

L’adaptateur miniport peut fractionner des trames Ethernet IPv4 qui incluent des options IPv4. L’adaptateur miniport peut prendre en charge le fractionnement de certaines options IPv4 sans en fractionner d’autres.

Note La carte réseau ne doit pas fractionner les trames IPv4 qui contiennent des options IPv4 non prises en charge. Si un frame IPv4 est fractionné, la partie d’en-tête du frame de fractionnement doit contenir l’en-tête IPv4 entier et toutes les options IPv4 présentes.

NDIS_HD_SPLIT_CAPS_SUPPORTS_IPV6_EXTENSION_HEADERS

L’adaptateur miniport peut fractionner des trames Ethernet IPv6 qui incluent des en-têtes d’extension IPv6. L’adaptateur miniport peut prendre en charge certains en-têtes d’extension IPv6 tout en ne prenant pas en charge d’autres.

Note La carte réseau ne doit pas fractionner les trames IPv6 qui contiennent des en-têtes d’extension IPv6 non pris en charge. Si une trame IPv6 est fractionnée, la partie d’en-tête du frame de fractionnement doit contenir l’en-tête IPv6 entier et tous les en-têtes d’extension IPv6 présents.

NDIS_HD_SPLIT_CAPS_SUPPORTS_TCP_OPTIONS

L’adaptateur miniport peut fractionner des trames TCP avec d’autres options TCP en plus de l’option timestamp. L’adaptateur miniport peut prendre en charge certaines options TCP et pas d’autres.

Note Si la seule option TCP dans un frame est l’option timestamp, le fournisseur de fractionnement des données doit être en mesure de fractionner le frame.

Note Si un en-tête TCP contient une option TCP non prise en charge, la carte réseau doit fractionner l’image au début de l’en-tête TCP ou ne doit pas fractionner le frame.

CurrentCapabilities

Fonctionnalités actuelles de fractionnement d’en-tête et de données prises en charge par l’adaptateur miniport. Le pilote miniport utilise les mêmes indicateurs que ceux définis pour le membre HardwareCapabilities . Dans ce cas, les indicateurs sont définis pour indiquer les fonctionnalités actuelles qui dépendent des paramètres de configuration actuels.

HDSplitFlags

Ensemble d’indicateurs qui signale la status de fractionnement d’en-tête-données pour un adaptateur miniport. NDIS définit ce membre avec un OR au niveau du bit des indicateurs suivants :

NDIS_HD_SPLIT_ENABLE_HEADER_DATA_SPLIT

Le pilote miniport a activé le fractionnement des données d’en-tête dans le matériel. Sinon, le fractionnement en-tête-données est désactivé.

HDSplitCombineFlags

Ensemble d’indicateurs qui spécifient les paramètres actuels de fractionnement d’en-tête-données d’un adaptateur miniport. La valeur de HDSplitCombineFlags peut être au niveau du bit OU des indicateurs suivants :

NDIS_HD_SPLIT_COMBINE_ALL_HEADERS

L’adaptateur miniport combine des trames fractionnées. Si le fractionnement d’en-tête-données est activé dans le matériel, le pilote miniport doit combiner l’en-tête et les données avant d’indiquer le frame à NDIS.

BackfillSize

Taille de remplissage, en octets, que le pilote miniport utilise pour la partie données d’un frame fractionné.

MaxHeaderSize

Taille maximale, en octets, que le pilote miniport utilise pour la partie d’en-tête d’un frame fractionné.

Note Si la longueur d’un en-tête dépasse MaxHeaderSize en raison de la présence d’options IPv4, d’en-têtes IPsec ou d’en-têtes d’extension IPv6, le frame ne doit pas être fractionné. Si un en-tête qui inclut un en-tête TCP ou UDP dépasse MaxHeaderSize en raison de la présence d’en-tête TCP, d’options TCP ou d’en-tête UDP, la carte réseau doit fractionner l’image au début de l’en-tête de protocole de couche supérieure ou ne doit pas fractionner le frame.

Remarques

La structure NDIS_HD_SPLIT_CURRENT_CONFIG est utilisée dans le OID_GEN_HD_SPLIT_CURRENT_CONFIG Demande de requête OID pour obtenir la configuration actuelle de fractionnement d’en-tête-données d’un adaptateur miniport.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Pris en charge dans NDIS 6.1 et versions ultérieures.
En-tête	ntddndis.h (include Ndis.h)

Voir aussi

NDIS_OBJECT_HEADER

NdisMSetMiniportAttributes

OID_GEN_HD_SPLIT_CURRENT_CONFIG

Partager via