NetRingGetElementAtIndex, fonction (ring.h)

La fonction NetRingGetElementAtIndex récupère un élément à partir d’un anneau net.

Syntaxe

void * NetRingGetElementAtIndex(
  [_In_] NET_RING const *Ring,
  [_In_] UINT32         Index
);

Paramètres

[_In_] Ring

Pointeur vers un NET_RING.

[_In_] Index

Index d’élément, dans la plage [0, Ring-NumberOfElements>).

Valeur retournée

Retourne l’élément à l’emplacement spécifié.

Remarques

NetRingGetElementAtIndex utilise le membre ElementStride de l’anneau net pour indexer dans la mémoire tampon et retourne l’emplacement de l’élément spécifié.

NetRingGetElementAtIndex est destiné à l’utilisation générique des anneaux nets. Au lieu de cela, un pilote client NetAdapterCx appelle généralement NetRingGetPacketAtIndex pour un anneau de paquets ou NetRingGetFragmentAtIndex pour un anneau de fragments.

Configuration requise

Condition requise Valeur
Plateforme cible Universal
Version KMDF minimale 1.29
En-tête ring.h (inclure netadaptercx.h)
IRQL N’importe quel niveau tant que la mémoire cible est résidente

Voir aussi

NetRingGetPacketAtIndex

NetRingGetFragmentAtIndex