KeTryToAcquireGuardedMutex 函数 (wdm.h)

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

语法

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

参数

[in, out] Mutex

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

返回值

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

言论

使用 KeReleaseGuardedMutex 释放互斥体。

KeTryToAcquireGuardedMutex 立即返回,无论它是否可以获取互斥体。 使用 KeAcquireGuardedMutex 将调用线程置于等待状态,直到互斥体可用。

调用 KeTryToAcquireGuardedMutex 的线程 隐式进入受保护的区域,其中所有 APC 都处于禁用状态。 在线程释放具有 KeReleaseGuardedMutex的互斥体之前,它们将保持禁用状态。

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

要求

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

另请参阅

KeReleaseGuardedMutex