Función KeInitializeMutex (wdm.h)

La rutina KeInitializeMutex 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 este valor en cero.

Valor devuelto

None

Observaciones

Para mejorar el rendimiento, use exclusiones mutuas rápidas o exclusiones mutuas protegidas. 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 residir: en la extensión del dispositivo de un objeto de dispositivo creado por el controlador, en la extensión del 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 Value
Cliente mínimo compatible Disponible a partir de Windows 2000.
Plataforma de destino Universal
Encabezado wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
Library NtosKrnl.lib
Archivo DLL NtosKrnl.exe
IRQL Cualquier nivel
Reglas de cumplimiento de DDI HwStorPortProhibitedDIs(storport)

Consulte también

ExInitializeFastMutex

KeReadStateMutex

KeReleaseMutex

KeWaitForMultipleObjects

KeWaitForSingleObject