structure NET_ADAPTER_TX_CAPABILITIES (netadapter.h)
La structure NET_ADAPTER_TX_CAPABILITIES décrit les fonctionnalités de transmission d’un adaptateur net.
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;
Size
Taille de cette structure, en octets.
MappingRequirement
Valeur NET_MEMORY_MAPPING_REQUIREMENT qui spécifie la façon dont 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 la 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 d'NET_DMA_CAPABILITIES allouée par le pilote et initialisée 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 NetMemoryMappingRequirementDmapped.
UMDF NetAdapterCX ne prend pas en charge DmaCapabilities. Les pilotes UMDF doivent définir ce membre sur NULL.
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 de NET_ADAPTER_TX_CAPABILITIES initialisée est passée en tant que paramètre à NetAdapterSetDatapathCapabilities.
| Exigence | Valeur |
|---|---|
| version minimale de KMDF | 1.27 |
| version minimale de UMDF | 2.33 |
| d’en-tête | netadapter.h (include netadaptercx.h) |