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


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

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

Синтаксис

BOOLEAN ExTryToAcquireFastMutex(
  PFAST_MUTEX FastMutex
);

Параметры

FastMutex

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

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

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

Замечания

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

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

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

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

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

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows 2000
заголовка wdm.h
IRQL <= APC_LEVEL
правил соответствия DDI HwStorPortProhibitedDDIs(storport), IrqlExApcLte1(wdm)

См. также

FAST_MUTEX

ExAcquireFastMutex

ExInitializeFastMutex

ExReleaseFastMutex