KeAcquireGuardedMutex 函数 (wdm.h)
KeAcquireGuardedMutex 例程获取受保护的互斥体。
语法
void KeAcquireGuardedMutex(
PKGUARDED_MUTEX Mutex
);
参数
Mutex
[in, out]指向受保护的互斥体 KGUARDED_MUTEX 结构的指针。 必须使用 KeInitializeGuardedMutex初始化此结构。
返回值
没有
言论
使用 KeReleaseGuardedMutex 释放通过 KeAcquireGuardedMutex获取的互斥体。
如果互斥体可用,KeAcquireGuardedMutex 会立即返回。 否则,调用线程将处于等待状态,直到互斥体可用。 若要避免在互斥锁不可用时进入等待状态,请使用 KeTryToAcquireGuardedMutex。
调用 KeAcquireGuardedMutex 的线程 隐式进入受保护的区域,其中禁用了所有 APC。 在线程释放具有 KeReleaseGuardedMutex的互斥体之前,它们将保持禁用状态。
无法以递归方式获取受保护的互斥体:如果线程在调用 KeAcquireGuardedMutex时已持有互斥体,则线程将死锁。
有关受保护的互斥体的详细信息,请参阅 快速互斥体和受保护的互斥体。
要求
要求 | 价值 |
---|---|
支持的最低服务器 | Windows Server 2003 |
标头 | wdm.h |
IRQL | <= APC_LEVEL |
DDI 符合性规则 | HwStorPortProhibitedDIS(storport),IrqlKeApcLte1(wdm) |