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

Статья
08/08/2023

Подпрограмма ExAcquireFastMutexUnsafe получает указанный быстрый мьютекс для вызывающего потока.

Синтаксис

void ExAcquireFastMutexUnsafe(
  PFAST_MUTEX FastMutex
);

Параметры

FastMutex

[вход, выход] Указатель на структуру FAST_MUTEX), для которую вызывающий объект предоставляет хранилище. Вызывающий объект ранее инициализировал эту структуру путем вызова подпрограммы ExInitializeFastMutex .

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

None

Remarks

ExAcquireFastMutexUnsafe переводит вызывающий объект в состояние ожидания, если указанный быстрый мьютекс не может быть получен немедленно. В противном случае вызывающему объекту предоставляется право владения мьютексом и монопольный доступ к ресурсу, который защищает мьютекс, пока вызывающий объект не освобождает мьютекс.

Любой быстрый мьютекс, полученный вызовом ExAcquireFastMutexUnsafe , должен быть освобожден вызовом процедуры ExReleaseFastMutexUnsafe .

Процедуры ExAcquireFastMutex и ExAcquireFastMutexUnsafe приводят к блокировке вызывающего потока, пока мьютекс не будет доступен. Подпрограмма ExTryToAcquireFastMutex немедленно возвращает значение FALSE , если другой поток уже получил мьютекс. ExAcquireFastMutex и ExTryToAcquireFastMutex вызывают IRQL до APC_LEVEL перед получением быстрого мьютекса. Драйверы должны использовать ExAcquireFastMutexUnsafe, который не вызывает IRQL, только если выполняется одно из следующих действий:

Поток уже выполняется в APC_LEVEL.
Поток получает мьютекс в критической области, которая была введена ранее при вызове подпрограммы KeEnterCriticalRegion или FsRtlEnterFileSystem .

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

Быстрые мьютексы и защищенные мьютексы

Блокировки, взаимоблокировки и синхронизация

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000
Верхняя часть	wdm.h
IRQL	APC_LEVEL
Правила соответствия DDI	HwStorPortProhibitedDIS(storport)