Funzione KeInitializeMutex (wdm.h)

La routine KeInitializeMutex inizializza un oggetto mutex, impostandolo su uno stato segnalato.

Sintassi

void KeInitializeMutex(
  [out] PRKMUTEX Mutex,
  [in]  ULONG    Level
);

Parametri

[out] Mutex

Puntatore a un oggetto mutex, per il quale il chiamante fornisce l'archiviazione. Lo spazio di archiviazione deve essere allineato a 4 byte su piattaforme a 32 bit e allineato a 8 byte su piattaforme a 64 bit.

[in] Level

Riservato. I driver impostano questo valore su zero.

Valore restituito

nessuno

Osservazioni

Per prestazioni migliori, usare mutex veloci o mutex sorvegliati. Per altre informazioni, vedere Alternative agli oggetti Mutex.

L'oggetto mutex viene inizializzato con uno stato iniziale segnalato.

L'archiviazione per un oggetto mutex deve risiedere: nell'estensione del dispositivo di un oggetto dispositivo creato dal driver, nell'estensione controller di un oggetto controller creato dal driver o in un pool non a pagina allocato dal chiamante.

Per altre informazioni sugli oggetti mutex, vedere Oggetti Mutex.

Requisiti

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 Qualsiasi livello
Regole di conformità DDI HwStorPortProhibitedDDIs(storport)

Vedi anche

ExInitializeFastMutex

KeReadStateMutex

KeReleaseMutex

KeWaitForMultipleObjects

KeWaitForSingleObject