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


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

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

Синтаксис

void ExInitializeFastMutex(
  [out] PFAST_MUTEX FastMutex
);

Параметры

[out] FastMutex

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

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

Никакой

Замечания

exInitializeFastMutex необходимо вызвать перед вызовами других процедур ExXxxFastMutex.

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

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

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

Требования

Требование Ценность
минимальные поддерживаемые клиентские Доступно начиная с Windows 2000.
целевая платформа Настольный
заголовка wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
библиотеки NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL

См. также

ExAcquireFastMutex

ExAcquireFastMutexUnsafe

ExReleaseFastMutex

ExReleaseFastMutexUnsafe

ExTryToAcquireFastMutex

FAST_MUTEX

KeInitializeMutex