Condividi tramite


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 la risorsa di archiviazione.

Valore restituito

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

Osservazioni

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 da routine, ad esempio KeReleaseMutex e KeWaitForSingleObject, che sincronizzano l'accesso allo stato mutex.

Per altre informazioni sugli oggetti mutex, vedere Oggetti Mutex.

Fabbisogno

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)

Vedere anche

ExInitializeFastMutex

KeInitializeMutex

KeReleaseMutex

KeWaitForSingleObject