Функция 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) |