Macro NdisInitializeListHead (ndis.h)
La fonction NdisInitializeListHead initialise une file d’attente doublement liée, gérée par le pilote.
Syntaxe
void NdisInitializeListHead(
[in] _ListHead
);
Paramètres
[in] _ListHead
Pointeur vers le stockage non paginé alloué par le pilote pour l’en-tête de la file d’attente ou de la liste verrouillée.
Valeur de retour
None
Remarques
NdisInitializeListHead peut être appelé à partir d’une fonction MiniportInitializeEx ou à partir d’une routine DriverEntry d’un pilote de protocole si le pilote met en file d’attente les requêtes en interne. Toutefois, les pilotes miniport configurent rarement des files d’attente internes, car la bibliothèque NDIS sérialise les requêtes et les paquets envoyés aux pilotes miniport.
Tout pilote NDIS qui gère une file d’attente interne est responsable de la synchronisation des accès des fonctions du pilote aux entrées en file d’attente. Les fonctions NdisInterlockedXxxList garantissent qu’une seule fonction de pilote peut accéder aux entrées en file d’attente à tout moment, même si le pilote s’exécute sur un ordinateur multiprocesseur, car la file d’attente est protégée par un verrou de rotation fourni par l’appelant.
Pour une file d’attente verrouillée, le pilote doit également fournir un stockage non paginé pour un verrou de rotation. Il doit initialiser le verrou de rotation avec la fonction NdisAllocateSpinLock avant de passer un pointeur vers ce verrou de rotation vers l’une des fonctions NdisInterlockedXxxList .
Les appelants de NdisInitializeListHead peuvent s’exécuter sur n’importe quel IRQL. Si NdisInitializeListHead est appelé dans IRQL >= DISPATCH_LEVEL le stockage pour ListHead doit être résident.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Pris en charge pour les pilotes NDIS 6.0 et NDIS 5.1 (voir NdisInitializeListHead (NDIS 5.1)) dans Windows Vista. Pris en charge pour les pilotes NDIS 5.1 (voir NdisInitializeListHead (NDIS 5.1)) dans Windows XP. |
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | ndis.h (inclure Ndis.h) |
| IRQL | N’importe quel niveau (voir la section Remarques) |
Voir aussi
DriverEntry des pilotes de protocole NDIS
NdisInterlockedInsertHeadList NdisInterlockedInsertTailList NdisInterlockedRemoveHeadList