Funzione KeReleaseMutex (wdm.h)
La routine KeReleaseMutex rilascia un oggetto mutex e specifica se il chiamante deve chiamare una delle routine KeWaitXxx non appena KeReleaseMutex restituisce il controllo.
LONG KeReleaseMutex(
[in, out] PRKMUTEX Mutex,
[in] BOOLEAN Wait
);
[in, out] Mutex
Puntatore a un oggetto mutex inizializzato per il quale il chiamante fornisce l'archiviazione.
[in] Wait
Specifica se la chiamata a KeReleaseMutex deve essere immediatamente seguita da una chiamata a una delle routine KeWaitXxx. Se TRUE, la chiamata KeReleaseMutex deve essere seguita da una chiamata a KeWaitForMultipleObjects, KeWaitForMutexObjecto KeWaitForSingleObject. Per altre informazioni, vedere la sezione Osservazioni seguente.
Se il valore restituito è zero, l'oggetto mutex è stato rilasciato e raggiunto uno stato di segnalato.
Per prestazioni migliori, usare mutex veloci o mutex sorvegliati. Per altre informazioni, vedere alternative agli oggetti Mutex.
Se l'oggetto mutex raggiunge uno stato segnalato, viene effettuato un tentativo di soddisfare un'attesa per l'oggetto mutex.
Un oggetto mutex può essere rilasciato solo dal thread che attualmente contiene il mutex. Se si tenta di rilasciare un mutex che il thread non contiene o se è stato acquisito un mutex in IRQL = DISPATCH_LEVEL e il thread non è in esecuzione in DISPATCH_LEVEL (e viceversa), la routine genera un'eccezione STATUS_ABANDONED o STATUS_MUTEX_NOT_OWNED.
Quando un oggetto mutex raggiunge uno stato segnalato, viene rimosso dall'elenco dei mutex mantenuti da tale thread. Se questo elenco non contiene più voci, viene ripristinata la priorità originale per il thread.
La routine KeReleaseMutex potrebbe generare temporaneamente irQL. Se il parametro wait è FALSE, la routine, prima che venga restituita, ripristina il runtime di integrazione sul valore originale che aveva all'inizio della chiamata.
Se Wait = TRUE, la routine restituisce senza abbassare irQL. In questo caso, la chiamata KeReleaseMutex deve essere immediatamente seguita da una chiamata KeWaitXxx. Impostando Wait = TRUE, il chiamante può impedire che si verifichi un cambio di contesto non necessario tra la chiamata KeReleaseMutex e la chiamata KeWaitXxx. La routine KeWaitXxx, prima che venga restituita, ripristina il valore originale di IRQL all'inizio della chiamata KeReleaseMutex. Sebbene IRQL disabiliti i commutatori di contesto tra le due chiamate, queste chiamate non possono essere usate in modo affidabile come inizio e fine di un'operazione atomica. Ad esempio, tra queste due chiamate, un thread in esecuzione contemporaneamente in un altro processore potrebbe modificare lo stato dell'oggetto evento o della destinazione dell'attesa.
Se il chiamante è in esecuzione in IRQL = DISPATCH_LEVEL o in un contesto di thread arbitrario, il parametro timeout per KeWaitXxx deve essere zero.
Se un mutex viene acquisito in modo ricorsivo, il thread di controllo deve chiamare KeReleaseMutex quante volte ha acquisito il mutex per impostarlo sullo stato segnalato.
Per altre informazioni sugli oggetti mutex, vedere Oggetti Mutex.
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile a partire da Windows 2000. |
| piattaforma di destinazione | Universale |
| intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| libreria | NtosKrnl.lib |
| dll | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |
| regole di conformità DDI | HwStorPortProhibitedDDIs(storport), IrqlKeDispatchLte(wdm) |