Funzione KeAcquireGuardedMutexUnsafe (wdm.h)

  • Articolo

KeAcquireGuardedMutexUnsafe acquisisce un mutex sorvegliato mentre si trova all'interno di un'area protetta.

Sintassi

void KeAcquireGuardedMutexUnsafe(
  PKGUARDED_MUTEX FastMutex
);

Parametri

FastMutex

[in, out] Puntatore alla struttura KGUARDED_MUTEX per il mutex sorvegliato.

Valore restituito

nessuno

Osservazioni

Usare KeReleaseGuardedMutexUnsafe per rilasciare un mutex sorvegliato acquisito con KeAcquireMutexUnsafe.

KeAcquireGuardedMutexUnsafe non inserisce implicitamente il thread chiamante all'interno di un'area protetta. Il codice racchiuso in una coppia KeAcquireGuardedMutexUnsafe/KeReleaseGuardedMutexUnsafe deve essere eseguita in IRQL = APC_LEVEL o all'interno di un'area protetta. Per il codice che non è garantito eseguire all'interno di un'area protetta, usare KeAcquireGuardedMutex e KeReleaseGuardedMutexUnsafe.

Non è possibile acquisire un mutex sorvegliato in modo ricorsivo: se un thread mantiene già il mutex quando chiama KeAcquireGuardedMutexUnsafe, il thread verrà deadlock.

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

Requisiti

Requisito Valore
Server minimo supportato Windows Server 2003
Intestazione wdm.h
IRQL <= APC_LEVEL
Regole di conformità DDI HwStorPortProhibitedDDDIs(storport), IrqlKeApcLte1(wdm)

Vedi anche

KGUARDED_MUTEX

KeReleaseGuardedMutexUnsafe