ExTryToAcquireFastMutex 函数 (wdm.h)
ExTryToAcquireFastMutex 例程获取给定的快速互斥体(如果可能),并禁用了当前线程的 APC。
语法
BOOLEAN ExTryToAcquireFastMutex(
PFAST_MUTEX FastMutex
);
参数
FastMutex
[in, out]指向要获取的快速互斥体的指针(如果当前不由另一个线程拥有)。
返回值
如果当前线程获得快速互斥体的所有权,则 ExTryToAcquireFastMutex 返回 TRUE。
言论
如果给定的快速互斥体当前未拥有,ExTryToAcquireFastMutex 向禁用当前线程的 APC 提供调用方所有权,直到它释放快速互斥体为止。
如果当前线程必须等待获取给定互斥体,然后才能执行有用的工作,请使用 ExAcquireFastMutex。
使用 ExTryToAcquireFastMutex 或 ExAcquireFastMutex 获取的任何快速互斥体都必须随 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) |