Функция KeInitializeMutex (wdm.h)
Программа KeInitializeMutex инициализирует объект мьютекса, задав его сигнальное состояние.
Синтаксис
void KeInitializeMutex(
[out] PRKMUTEX Mutex,
[in] ULONG Level
);
Параметры
[out] Mutex
Указатель на объект мьютекса, для которого вызывающий объект предоставляет хранилище. Хранилище должно быть 4-байтовое выравнивание на 32-разрядных платформах, а 8-байтовое выравнивание на 64-разрядных платформах.
[in] Level
Скрытный. Драйверы устанавливают это значение нулю.
Возвращаемое значение
Никакой
Замечания
Для повышения производительности используйте быстрые мьютекси или защищенные мьютексы. Дополнительные сведения см. в разделе Альтернативы объектам Мьютекса.
Объект мьютекса инициализирован с начальным состоянием сигнала.
Хранилище для объекта мьютекса должно быть резидентом: в расширении устройства созданного драйвером объекта устройства, в расширении контроллера объекта контроллера, созданного драйвером, или в непагованном пуле, выделенном вызывающим объектом.
Дополнительные сведения об объектах мьютекса см. в объектах Mutex.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно начиная с Windows 2000. |
| целевая платформа | Всеобщий |
| заголовка | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| библиотеки | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | Любой уровень |
| правил соответствия DDI | HwStorPortProhibitedDIs(storport) |