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 符合性规则 | HwStorPortProhibitedDDI (storport) ， IrqlKeApcLte1 (wdm) |