structure NET_ADAPTER_TX_CAPABILITIES (netadapter.h)
La structure NET_ADAPTER_TX_CAPABILITIES décrit les fonctionnalités de transmission d’un adaptateur net.
Syntaxe
typedef struct _NET_ADAPTER_TX_CAPABILITIES {
ULONG Size;
NET_MEMORY_MAPPING_REQUIREMENT MappingRequirement;
SIZE_T PayloadBackfill;
SIZE_T MaximumNumberOfFragments;
SIZE_T FragmentBufferAlignment;
UINT32 FragmentRingNumberOfElementsHint;
SIZE_T MaximumNumberOfQueues;
NET_ADAPTER_DMA_CAPABILITIES *DmaCapabilities;
} NET_ADAPTER_TX_CAPABILITIES;
Membres
Size
Taille de cette structure, en octets.
MappingRequirement
Valeur NET_MEMORY_MAPPING_REQUIREMENT qui spécifie comment le système d’exploitation doit mapper les mémoires tampons de données de transmission.
Les pilotes UMDF doivent définir MappingRequirement sur NetMemoryMappingRequirementNone.
PayloadBackfill
Quantité d’espace, en octets, réservée au pilote client avant le début de la charge utile de chaque NET_PACKET.
MaximumNumberOfFragments
Nombre maximal de fragments par paquet que l’adaptateur peut gérer, ou ((SIZE_T) - 1) s’il n’existe aucune limite.
FragmentBufferAlignment
Alignement minimal pour les fragments de paquets. Ce membre doit être un pouvoir de 2.
FragmentRingNumberOfElementsHint
Indicateur indiquant le nombre d’éléments souhaités par l’adaptateur pour la mémoire tampon en anneau NET_FRAGMENT de chaque file d’attente de transmission. Ce membre doit être un pouvoir de 2.
MaximumNumberOfQueues
Nombre maximal de files d’attente de transmission que l’adaptateur prend en charge.
DmaCapabilities
Pointeur vers une structure de NET_DMA_CAPABILITIES allouée et initialisée par le pilote qui décrit les fonctionnalités DMA de l’adaptateur sur le chemin de transmission. Ce membre est ignoré par NetAdapterCx si MappingRequirement n’est pas défini sur NetMemoryMappingRequirementDmaMapped.
UMDF NetAdapterCX ne prend pas en charge DmaCapabilities. Les pilotes UMDF doivent définir ce membre sur NULL.
Remarques
Appelez l’une des fonctions NET_ADAPTER_TX_CAPABILITIES_INIT_XXX pour initialiser cette structure. Pour plus d’informations sur chaque fonction d’initialisation, consultez les liens de la section Voir aussi.
Une structure NET_ADAPTER_TX_CAPABILITIES initialisée est passée en tant que paramètre à NetAdapterSetDatapathCapabilities.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Version KMDF minimale | 1,27 % |
| Version UMDF minimale | 2,33 |
| En-tête | netadapter.h (inclure netadaptercx.h) |