structure NDIS_HD_SPLIT_ATTRIBUTES (ndis.h)

2025-02-07

La structure NDIS_HD_SPLIT_ATTRIBUTES définit les attributs de fractionnement des données d’en-tête, le cas échéant, associés à un adaptateur miniport.

Syntaxe

typedef struct _NDIS_HD_SPLIT_ATTRIBUTES {
  NDIS_OBJECT_HEADER Header;
  ULONG              HardwareCapabilities;
  ULONG              CurrentCapabilities;
  ULONG              HDSplitFlags;
  ULONG              BackfillSize;
  ULONG              MaxHeaderSize;
} NDIS_HD_SPLIT_ATTRIBUTES, *PNDIS_HD_SPLIT_ATTRIBUTES;

Membres

Header

Structure NDIS_OBJECT_HEADER pour la structure des caractéristiques du fournisseur (NDIS_HD_SPLIT_ATTRIBUTES). Le pilote définit le membre type de de la structure spécifiée par -en-tête sur NDIS_OBJECT_TYPE_HD_SPLIT_ATTRIBUTES, le membre révision sur NDIS_OBJECT_HD_SPLIT_ATTRIBUTES_REVISION_1 et le membre Size sur NDIS_SIZEOF_HD_SPLIT_ATTRIBUTES_REVISION_1.

HardwareCapabilities

Fonctionnalités matérielles de fractionnement des données d’en-tête 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 par le biais de la page de propriétés avancées. La valeur de HardwareCapabilities est une or au niveau du bit 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 dll 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 tout en ne fractionnant pas d’autres.

Remarque La carte réseau ne doit pas fractionner les trames IPv4 qui contiennent des options IPv4 non prises en charge. Si une trame IPv4 est fractionnée, la partie en-tête du frame fractionné 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.

Remarque 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 en-tête de l’image fractionnée doit contenir l’ensemble de l’en-tête IPv6 et tous les en-têtes d’extension IPv6 présents.

NDIS_HD_SPLIT_CAPS_SUPPORTS_TCP_OPTIONS

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

Remarque Si la seule option TCP d’une image est l’option timestamp, le fournisseur de fractionnement de données doit être en mesure de fractionner le frame.

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

CurrentCapabilities

Fonctionnalités actuelles de fractionnement des données d’en-tête 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 contrôlent l’état du fractionnement des données d’en-tête pour un adaptateur miniport. Le pilote miniport doit définir ce membre sur zéro avant d’appeler le fonction NdisMSetMiniportAttributes. Une fois NdisMSetMiniportAttributes correctement retourné, le pilote doit vérifier les indicateurs et configurer le matériel en conséquence. NDIS définit ce membre avec une or au niveau du bit des indicateurs suivants :

NDIS_HD_SPLIT_ENABLE_HEADER_DATA_SPLIT

Si cet indicateur est défini, le pilote miniport doit activer le fractionnement des données d’en-tête dans le matériel. Sinon, le fractionnement des données d’en-tête est désactivé. Si l’ordinateur utilise le fractionnement des données d’en-tête et que le pilote miniport définit également l’indicateur NDIS_HD_SPLIT_CAPS_SUPPORTS_HEADER_DATA_SPLIT dans le membre CurrentCapabilities, NDIS définit NDIS_HD_SPLIT_ENABLE_HEADER_DATA_SPLIT.

BackfillSize

Taille de remplissage, en octets, pour la partie données d’une trame fractionnée. Le pilote miniport doit être défini
BackfillSize à zéro avant d’appeler NdisMSetMiniportAttributes. NDIS définit ce membre si le pilote miniport doit préallouer le stockage de remplissage dans la partie données pour les trames fractionnées. Après NdisMSetMiniportAttributes retourne correctement, le pilote doit utiliser la valeur BackfillSize définie par NDIS pour préallouer les mémoires tampons de données.

MaxHeaderSize

Taille maximale, en octets, pour la partie d’en-tête d’un frame fractionné. Le pilote miniport doit définir MaxHeaderSize sur zéro avant d’appeler NdisMSetMiniportAttributes. NDIS définit ce membre sur la taille maximale de la mémoire tampon d’en-tête pour les trames fractionnées. Après NdisMSetMiniportAttributes retourne correctement, le pilote doit utiliser la valeur fournie par NDIS.

Remarque Si la longueur d’un en-tête dépasse MaxHeaderSize en raison de la présence d’options IPv4, d’en-têtes d’extension IPSec ou 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 le cadre au début de l’en-tête du protocole de couche supérieure ou ne pas fractionner le cadre.

Remarques

Pour prendre en charge le fractionnement des données d’en-tête, un pilote miniport transmet un pointeur à un structure NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES dans le paramètre MiniportAttributes du fonction NdisMSetMiniportAttributes. Le HDSplitAttributes membre de NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES contient un pointeur vers la structure NDIS_HD_SPLIT_ATTRIBUTES. Un pilote miniport appelle NdisMSetMiniportAttributes à partir de sa fonction MiniportInitializeEx lors de l’initialisation.