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

Voir aussi

NET_ADAPTER_TX_CAPABILITIES_INIT

NET_ADAPTER_TX_CAPABILITIES_INIT_FOR_DMA