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

  • Статья

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

Синтаксис

BOOLEAN ExTryToAcquireFastMutex(
  PFAST_MUTEX FastMutex
);

Параметры

FastMutex

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

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

ExTryToAcquireFastMutex возвращает значение TRUE , если текущему потоку предоставлено право владения быстрым мьютексом.

Комментарии

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

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

Любой быстрый мьютекс, полученный с помощью ExTryToAcquireFastMutex или ExAcquireFastMutex , должен быть освобожден с помощью ExReleaseFastMutex.

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

Вызывающие функции ExTryToAcquireFastMutex должны выполняться в irQL <= APC_LEVEL. ExTryToAcquireFastMutex задает для IRQL значение APC_LEVEL, если мьютекс получен, а вызывающий объект продолжает выполняться в APC_LEVEL после возврата ExTryToAcquireFastMutex . Однако ExTryToAcquireFastMutex сохраняет предыдущий irQL вызывающего объекта в мьютексе, если это успешно, и этот irQL восстанавливается, когда вызывающий вызывает ExReleaseFastMutex.

Требования

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

См. также раздел

FAST_MUTEX

ExAcquireFastMutex

ExInitializeFastMutex

ExReleaseFastMutex