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