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