Funzione KeReadStateMutex (wdm.h)

La routine KeReadStateMutex restituisce lo stato corrente, segnalato o non segnalato, dell'oggetto mutex specificato.

Sintassi

LONG KeReadStateMutex(
  [in] PRKMUTEX Mutex
);

Parametri

[in] Mutex

Puntatore a un oggetto mutex inizializzato per il quale il chiamante fornisce l'archiviazione.

Valore restituito

Se il valore restituito è 1, lo stato dell'oggetto mutex viene segnalato.

Commenti

Questa routine fornisce un modo efficiente per eseguire il polling dello stato del segnale di un mutex. KeReadStateMutex legge lo stato del mutex senza sincronizzarne l'accesso al mutex. Non presupporre che gli accessi di uno stato mutex da KeReadStateMutex si escludono a vicenda dagli accessi di routine, ad esempio KeReleaseMutex e KeWaitForSingleObject, che sincronizzano l'accesso allo stato mutex.

Per altre informazioni sugli oggetti mutex, vedere Oggetti Mutex.

Requisiti

Vedi anche

ExInitializeFastMutex

KeInitializeMutex

KeReleaseMutex

KeWaitForSingleObject