NetRingCollectionGetFragmentRing, fonction (ringcollection.h)
Le NetRingCollectionGetFragmentRing obtient l’anneau de fragment pour une file d’attente de paquets.
Syntaxe
NET_RING * NetRingCollectionGetFragmentRing(
NET_RING_COLLECTION const *Rings
);
Paramètres
Rings
Pointeur vers une structure NET_RING_COLLECTION qui décrit les anneaux nets de cette file d’attente de paquets.
Valeur de retour
Retourne un pointeur vers le fragment NET_RING pour la file d’attente de paquets.
Remarques
Les pilotes clients appellent généralement cette fonction lorsqu’ils doivent travailler directement avec un anneau de fragments, par exemple lorsque le pilote publie des informations sur le matériel. Par exemple, pendant la transmission d’un pilote, vous pouvez utiliser le ElementIndexMask de l’anneau de fragments pour récupérer le fragment correct qui est publié sur le matériel afin de remplir le descripteur matériel.
Pour obtenir des exemples d’utilisation de cette fonction, consultez la exemple de pilote Realtek.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| version minimale de KMDF | 1.29 |
| version minimale de UMDF | 2.33 |
| d’en-tête | ringcollection.h (include netadaptercx.h) |
| IRQL | Tout niveau tant que la mémoire cible est résidente |