Compartir a través de


Función KeInitializeMutex (wdm.h)

El KeInitializeMutex rutina inicializa un objeto de exclusión mutua y lo establece en un estado señalado.

Sintaxis

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

Parámetros

[out] Mutex

Puntero a un objeto de exclusión mutua, para el que el autor de la llamada proporciona el almacenamiento. El almacenamiento debe estar alineado con 4 bytes en plataformas de 32 bits y 8 bytes alineados en plataformas de 64 bits.

[in] Level

Reservado. Los controladores establecen esto en cero.

Valor devuelto

Ninguno

Observaciones

Para mejorar el rendimiento, use exclusiones mutuas rápidas o exclusión mutua protegida. Para obtener más información, vea Alternativas a objetos de exclusión mutua.

El objeto de exclusión mutua se inicializa con un estado inicial de señalizado.

El almacenamiento de un objeto de exclusión mutua debe estar residente: en la extensión del dispositivo de un objeto de dispositivo creado por el controlador, en la extensión de controlador de un objeto de controlador creado por el controlador o en un grupo no paginado asignado por el autor de la llamada.

Para obtener más información sobre los objetos de exclusión mutua, vea Objetos de exclusión mutua.

Requisitos

Requisito Valor
cliente mínimo admitido Disponible a partir de Windows 2000.
de la plataforma de destino de Universal
encabezado de wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
biblioteca de NtosKrnl.lib
DLL de NtosKrnl.exe
irQL Cualquier nivel
reglas de cumplimiento de DDI HwStorPortProhibitedDIs(storport)

Consulte también

ExInitializeFastMutex

keReadStateMutex

keReleaseMutex

keWaitForMultipleObjects

KeWaitForSingleObject