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) |