ExTryToAcquireFastMutex 函数 (wdm.h)

ExTryToAcquireFastMutex 例程获取给定的快速互斥体(如果可能),并禁用了当前线程的 APC。

语法

BOOLEAN ExTryToAcquireFastMutex(
  PFAST_MUTEX FastMutex
);

参数

FastMutex

[in, out]指向要获取的快速互斥体的指针(如果当前不由另一个线程拥有)。

返回值

如果当前线程获得快速互斥体的所有权,则 ExTryToAcquireFastMutex 返回 TRUE

言论

如果给定的快速互斥体当前未拥有,ExTryToAcquireFastMutex 向禁用当前线程的 APC 提供调用方所有权,直到它释放快速互斥体为止。

如果当前线程必须等待获取给定互斥体,然后才能执行有用的工作,请使用 ExAcquireFastMutex

使用 ExTryToAcquireFastMutexExAcquireFastMutex 获取的任何快速互斥体都必须随 ExReleaseFastMutex一起发布。

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

ExTryToAcquireFastMutex 的调用方必须在 IRQL <= APC_LEVEL 上运行。 ExTryToAcquireFastMutex 在获取互斥体后将 IRQL 设置为APC_LEVEL,调用方在 ExTryToAcquireFastMutex 返回后继续在APC_LEVEL运行。 ExTryToAcquireFastMutex 如果成功,则会在互斥表达式中保存调用方以前的 IRQL,并在调用方调用 ExReleaseFastMutex时还原 IRQL。

要求

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

另请参阅

FAST_MUTEX

ExAcquireFastMutex

ExInitializeFastMutex

ExReleaseFastMutex