Поделиться через


Функция KeInitializeMutex (wdm.h)

Подпрограмма KeInitializeMutex инициализирует объект мьютекса, задавая его в состояние сигнала.

Синтаксис

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

Параметры

[out] Mutex

Указатель на объект мьютекса, для которого вызывающий объект предоставляет хранилище. Хранилище должно быть выровнено по 4 байтам на 32-разрядных платформах и 8-байтово на 64-разрядных платформах.

[in] Level

Зарезервировано. Драйверы устанавливают для этого параметра нулевое значение.

Возвращаемое значение

None

Remarks

Для повышения производительности используйте быстрые мьютексы или защищенные мьютексы. Дополнительные сведения см. в статье Альтернатива объектам мьютекса.

Объект мьютекса инициализируется с начальным состоянием signaled.

Хранилище для объекта мьютекса должно быть резидентным: в расширении устройства объекта устройства, созданного драйвером, в расширении контроллера созданного драйвером объекта контроллера или в неупакованном пуле, выделенном вызывающим объектом.

Дополнительные сведения об объектах мьютексов см. в разделе Объекты мьютекса.

Требования

Требование Значение
Минимальная версия клиента Доступно начиная с Windows 2000.
Целевая платформа Универсальное
Верхняя часть wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h)
Библиотека NtosKrnl.lib
DLL NtosKrnl.exe
IRQL Любой уровень
Правила соответствия DDI HwStorPortProhibitedDIs(storport)

См. также раздел

ExInitializeFastMutex

KeReadStateMutex

KeReleaseMutex

KeWaitForMultipleObjects

KeWaitForSingleObject