Funzione ExReleaseFastMutex (wdm.h)

Articolo
02/27/2024

La routine ExReleaseFastMutex rilascia la proprietà di un mutex veloce acquisito con ExAcquireFastMutex o ExTryToAcquireFastMutex.

Sintassi

void ExReleaseFastMutex(
  PFAST_MUTEX FastMutex
);

Parametri

FastMutex

[in, out] Puntatore al mutex veloce da rilasciare.

Valore restituito

nessuno

Osservazioni

ExReleaseFastMutex rilascia la proprietà del mutex rapido specificato e imposta irQL sul valore in cui il chiamante è stato eseguito prima di chiamarlo ExAcquireFastMutex. Se il precedente IRQL è minore di APC_LEVEL, il recapito delle API al thread corrente viene riabilitabile.

Si tratta di un errore di programmazione per chiamare ExReleaseFastMutex con un fastMutex acquisito usando ExAcquireFastMutexUnsafe. I driver devono rilasciare un mutex veloce dallo stesso thread che lo ha acquisito. I mutex veloci devono essere rilasciati nell'ordine opposto dall'ordine acquisito.

Per altre informazioni sui mutex veloci, vedere Mutex veloci e Mutex sorvegliati.

I chiamanti di ExReleaseFastMutex devono essere in esecuzione in IRQL = APC_LEVEL. Nella maggior parte dei casi, irQL sarà già impostato su APC_LEVEL prima che ExReleaseFastMutex venga chiamato perché ExAcquireFastMutex ha già impostato irQL su APC_LEVEL automaticamente. Tuttavia, se il chiamante cambia irQL dopo che ExAcquireFastMutex restituisce, il chiamante deve impostare in modo esplicito irQL su APC_LEVEL prima di chiamare ExReleaseFastMutex.