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

Статья
08/08/2023

Подпрограмма ExInitializeFastMutex инициализирует переменную быстрого мьютекса, используемую для синхронизации взаимоисключающего доступа набора потоков к общему ресурсу.

Синтаксис

void ExInitializeFastMutex(
  [out] PFAST_MUTEX FastMutex
);

Параметры

[out] FastMutex

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

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

None

Remarks

Метод ExInitializeFastMutex должен вызываться перед вызовами других подпрограмм ExXxxFastMutex .

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

Для повышения производительности используйте процедуры ExXxxFastMutex вместо процедур KeXxxMutex . Однако быстрый мьютекс не может быть получен рекурсивно, как мьютекс ядра.

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

Требования

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