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)

另请参阅

KGUARDED_MUTEX

KeReleaseGuardedMutex