ExAcquireFastMutex function (wdm.h)
The ExAcquireFastMutex routine acquires the given fast mutex with APCs to the current thread disabled.
Syntax
void ExAcquireFastMutex(
PFAST_MUTEX FastMutex
);
Parameters
FastMutex
[in, out] A pointer to an initialized fast mutex for which the caller provides the storage.
Return value
None
Remarks
ExAcquireFastMutex puts the caller into a wait state if the given fast mutex cannot be acquired immediately. Otherwise, the caller is given ownership of the fast mutex with APCs to the current thread disabled until it releases the fast mutex.
Use ExTryToAcquireFastMutex if the current thread can do other work before it waits on the acquisition of the given mutex.
Any fast mutex that is acquired using ExAcquireFastMutex or ExTryToAcquireFastMutex must be released with ExReleaseFastMutex.
For more information about fast mutexes, see Fast Mutexes and Guarded Mutexes.
Callers of ExAcquireFastMutex must be running at IRQL <= APC_LEVEL. ExAcquireFastMutex sets the IRQL to APC_LEVEL, and the caller continues to run at APC_LEVEL after ExAcquireFastMutex returns. ExAcquireFastMutex saves the caller's previous IRQL in the mutex, however, and that IRQL is restored when the caller invokes ExReleaseFastMutex.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 |
| Header | wdm.h |
| IRQL | <= APC_LEVEL |
| DDI compliance rules | HwStorPortProhibitedDDIs(storport), IrqlExApcLte1(wdm) |