NdisInitializeListHead-Makro (ndis.h)

Die NdisInitializeListHead-Funktion initialisiert eine doppelt verknüpfte, vom Treiber verwaltete Warteschlange.

Syntax

void NdisInitializeListHead(
  [in]  _ListHead
);

Parameter

[in] _ListHead

Ein Zeiger auf den vom Treiber zugewiesenen nicht ausgelagerten Speicher für den Kopf der ineinander verriegelten Warteschlange oder Liste.

Rückgabewert

Keine

Bemerkungen

NdisInitializeListHead kann von einer MiniportInitializeEx-Funktion oder von der DriverEntry-Routine eines Protokolltreibers aufgerufen werden, wenn der Treiber Anforderungen intern in die Warteschlange stellt. Miniporttreiber richten jedoch selten interne Warteschlangen ein, da die NDIS-Bibliothek Anforderungen und Pakete serialisiert, die an Miniporttreiber gesendet werden.

Jeder NDIS-Treiber, der eine interne Warteschlange verwaltet, ist für die Synchronisierung der Zugriffe von Treiberfunktionen auf Warteschlangeneinträge verantwortlich. Die NdisInterlockedXxxList-Funktionen stellen sicher, dass nur eine Treiberfunktion jederzeit auf Einträge in der Warteschlange zugreifen kann, auch wenn der Treiber auf einem Multiprozessorcomputer ausgeführt wird, da die Warteschlange durch eine vom Aufrufer bereitgestellte Spinsperre geschützt ist.

Für eine ineinander verriegelte Warteschlange muss der Treiber auch nicht ausgelagerten Speicher für eine Spinsperre bereitstellen. Es muss die Spinsperre mit der NdisAllocateSpinLock-Funktion initialisieren, bevor ein Zeiger auf diese Spinsperre an eine der NdisInterlockedXxxList-Funktionen übergeben wird .

Aufrufer von NdisInitializeListHead können in jedem IRQL ausgeführt werden. Wenn NdisInitializeListHead unter IRQL >= DISPATCH_LEVEL aufgerufen wird, muss der Speicher für ListHead resident sein.

Anforderungen

Weitere Informationen

DriverEntry von NDIS-Protokolltreibern

MiniportInitializeEx

NdisAllocateSpinLock