KeTryToAcquireGuardedMutex 函数 (wdm.h)

KeTryToAcquireGuardedMutex 例程获取受保护的互斥体(如果可用)。

语法

BOOLEAN KeTryToAcquireGuardedMutex(
  [in, out] PKGUARDED_MUTEX Mutex
);

参数

[in, out] Mutex

指向受保护的互斥 体的KGUARDED_MUTEX 结构的指针。

返回值

如果获取互斥体,则 KeTryToAcquireGuardedMutex 返回 TRUE,否则返回 FALSE

注解

使用 KeReleaseGuardedMutex 释放互斥体。

无论 KeTryToAcquireGuardedMutex 能否获取互斥体,KeTryToAcquireGuardedMutex 都会立即返回。 使用 KeAcquireGuardedMutex 将调用线程置于等待状态,直到 mutex 变为可用。

调用 KeTryToAcquireGuardedMutex 的 线程将隐式进入一个受保护的区域,其中所有 APC 都被禁用。 它们一直处于禁用状态,直到线程使用 KeReleaseGuardedMutex 释放互斥体。

有关受保护的互斥体的详细信息,请参阅 快速互斥体和受保护的互斥体

要求

要求
最低受支持的客户端 在 Windows Server 2003 及更高版本的 Windows 中可用。
目标平台 通用
标头 wdm.h(包括 Wdm.h、Ntddk.h、Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL
DDI 符合性规则 HwStorPortProhibitedDDI (storport) IrqlKeApcLte1 (wdm)

另请参阅

KeReleaseGuardedMutex