KeReadStateMutex 函数 (wdm.h)

  • 项目

KeReadStateMutex 例程返回指定互斥对象的当前状态（已发出信号或未发出信号）。

语法

LONG KeReadStateMutex(
  [in] PRKMUTEX Mutex
);

参数

[in] Mutex

指向调用方为其提供存储的已初始化互斥对象的指针。

返回值

如果返回值为 1，则会向互斥对象的状态发出信号。

注解

此例程提供了一种有效的方法来轮询互斥体的信号状态。 KeReadStateMutex 读取互斥体的状态，而不同步其对互斥体的访问权限。 不要假设 KeReadStateMutex 对互斥状态的访问是相互排斥的，由例程（如 KeReleaseMutex 和 KeWaitForSingleObject）来同步它们对互斥状态的访问。

有关互斥对象的详细信息，请参阅 互斥对象。

要求

要求 值
最低受支持的客户端 从 Windows 2000 开始可用。
目标平台 通用
标头 wdm.h（包括 Wdm.h、Ntddk.h、Ntifs.h）
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL
DDI 符合性规则 HwStorPortProhibitedDDI (storport)

另请参阅

ExInitializeFastMutex

KeInitializeMutex

KeReleaseMutex

KeWaitForSingleObject