exAcquireFastMutex 函数 (wdm.h)

  • 项目

ExAcquireFastMutex 例程通过 APC 获取给定的快速互斥体，以禁用当前线程。

语法

void ExAcquireFastMutex(
  PFAST_MUTEX FastMutex
);

参数

FastMutex

[in， out]指向调用方为其提供存储的已初始化快速互斥体的指针。

返回值

无

备注

如果无法立即获取给定的快速互斥体，ExAcquireFastMutex 会将调用方置于等待状态。 否则，调用方会将快速互斥锁的所有权授予禁用当前线程的快速互斥，直到它释放快速互斥。

如果当前线程在等待获取给定互斥体之前可以执行其他工作，请使用 ExTryToAcquireFastMutex 。

使用 ExAcquireFastMutex 或 ExTryToAcquireFastMutex 获取的任何快速互斥体都必须使用 ExReleaseFastMutex 释放。

有关快速互斥的详细信息，请参阅 快速互斥体和受保护的互斥体。

ExAcquireFastMutex 的调用方必须在 IRQL <= APC_LEVEL 运行。 ExAcquireFastMutex 将 IRQL 设置为 APC_LEVEL，在 ExAcquireFastMutex 返回后，调用方将继续在 APC_LEVEL 运行。 但是，ExAcquireFastMutex 会将调用方以前的 IRQL 保存在互斥体中，当调用方调用 ExReleaseFastMutex 时，IRQL 将还原。

要求

要求 值
最低受支持的客户端 Windows 2000
标头 wdm.h
IRQL <= APC_LEVEL
DDI 符合性规则 HwStorPortProhibitedDDI (storport) ， IrqlExApcLte1 (wdm)

另请参阅

FAST_MUTEX

ExAcquireFastMutexUnsafe

ExInitializeFastMutex

ExReleaseFastMutex

ExTryToAcquireFastMutex