NET_ADAPTER_TX_CAPABILITIES structure (netadapter.h)

  • Article

La structure NET_ADAPTER_TX_CAPABILITIES décrit les fonctionnalités de transmission d’un adaptateur réseau.

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.

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’y a 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 d’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 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.

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 %
En-tête netadapter.h (inclure netadaptercx.h)

Voir aussi

NET_ADAPTER_TX_CAPABILITIES_INIT

NET_ADAPTER_TX_CAPABILITIES_INIT_FOR_DMA