Condividi tramite


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 la risorsa di 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 essere residente: 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 di pagine allocato dal chiamante.

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

Vedere anche

ExInitializeFastMutex

KeReadStateMutex

KeReleaseMutex

KeWaitForMultipleObjects

KeWaitForSingleObject