KeInitializeMutex-Funktion (wdm.h)
Die KeInitializeMutex Routine initialisiert ein Mutex-Objekt und legt es auf einen signalisierten Zustand fest.
Syntax
void KeInitializeMutex(
[out] PRKMUTEX Mutex,
[in] ULONG Level
);
Parameter
[out] Mutex
Zeiger auf ein Mutex-Objekt, für das der Aufrufer den Speicher bereitstellt. Der Speicher muss auf 32-Bit-Plattformen ausgerichtet sein und 8-Byte auf 64-Bit-Plattformen ausgerichtet sein.
[in] Level
Reserviert. Dies wird von Treibern auf Null festgelegt.
Rückgabewert
Nichts
Bemerkungen
Um eine bessere Leistung zu erzielen, verwenden Sie schnelle Mutexe oder geschützte Mutexe. Weitere Informationen finden Sie unter Alternativen zu Mutex Objects.
Das Mutex-Objekt wird mit einem anfänglichen Signalzustand initialisiert.
Speicher für ein Mutex-Objekt muss resident sein: in der Geräteerweiterung eines vom Treiber erstellten Geräteobjekts, in der Controllererweiterung eines vom Treiber erstellten Controllerobjekts oder im vom Aufrufer zugewiesenen nicht ausgelagerten Pool.
Weitere Informationen zu Mutex-Objekten finden Sie unter Mutex Objects.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Ab Windows 2000 verfügbar. |
| Zielplattform- | Universal |
| Header- | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | Beliebige Ebene |
| DDI-Complianceregeln | HwStorPortProhibitedDIs(storport) |