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)

另请参阅

KGUARDED_MUTEX

KeReleaseGuardedMutex