KeInitializeMutex-Funktion (wdm.h)
Die KeInitializeMutex-Routine initialisiert ein Mutex-Objekt und setzt es auf einen signalisierten Zustand.
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 4-Byte auf 32-Bit-Plattformen ausgerichtet und 8 Byte auf 64-Bit-Plattformen ausgerichtet sein.
[in] Level
Reserviert. Treiber legen dies auf 0 (null) fest.
Rückgabewert
Keine
Bemerkungen
Verwenden Sie schnelle Mutexe oder geschützte Mutexe, um eine bessere Leistung zu erzielen. Weitere Informationen finden Sie unter Alternativen zu Mutex-Objekten.
Das Mutex-Objekt wird mit einem anfangs signalisierten Zustand initialisiert.
Der 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 in einem nicht ausgelagerten Pool, der vom Aufrufer zugeordnet wird.
Weitere Informationen zu Mutex-Objekten finden Sie unter Mutex-Objekte.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar ab Windows 2000. |
| Zielplattform | Universell |
| Header | wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h) |
| Bibliothek | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | Beliebige Ebene |
| DDI-Complianceregeln | HwStorPortProhibitedDIs(storport) |