NDIS_INIT_MUTEX Makro (ndis.h)

Artikel
02/27/2024

Das NDIS_INIT_MUTEX-Makro initialisiert ein Mutex-Objekt und legt es auf einen signalierten Zustand fest.

Syntax

void NDIS_INIT_MUTEX(
   _M_
);

Parameter

_M_

Ein Zeiger auf ein vom Aufrufer bereitgestelltes NDIS_MUTEX mutex-Objekt. NDIS_MUTEX ist ein Wrapper für KMUTEX.

Rückgabewert

Keine

Bemerkungen

NDIS-Netzwerktreiber sollten das makro NDIS_INIT_MUTEX verwenden, um einen Mutex zu initialisieren.

Der Anfangszustand des Mutex-Objekts ist der signalierte Zustand. Rufen Sie zum Abrufen des Mutex das Makro NDIS_WAIT_FOR_MUTEX auf. Rufen Sie zum Freigeben des Mutex das Makro NDIS_RELEASE_MUTEX auf.

Ein Treiber kann nicht auf ein Zeitintervall ungleich null für ein Mutex-Objekt bei einem ausgelösten IRQL oder in einem beliebigen Threadkontext warten (d. a. der Kontext eines Threads, der aktuell ist, wenn eine Treiberfunktion aufgerufen wird).

Der Speicher für ein Mutex-Objekt muss sich in einem Treiberkontextbereich oder in einem nicht ausgelagerten Pool befinden, den der Aufrufer zugewiesen hat.

Das makro NDIS_INIT_MUTEX ist ein NDIS-Wrapper für die KeInitializeMutex-Routine .