keInitializeMutex 函数 (wdm.h)

KeInitializeMutex 例程初始化互斥对象,将其设置为信号状态。

语法

void KeInitializeMutex(
  [out] PRKMUTEX Mutex,
  [in]  ULONG    Level
);

参数

[out] Mutex

指向互斥对象的指针,调用方为其提供存储。 存储必须在 32 位平台上对齐 4 字节,在 64 位平台上必须是 8 字节对齐的。

[in] Level

保留。 驱动程序将此设置为零。

返回值

备注

为了获得更好的性能,请使用快速互斥体或受保护的互斥体。 有关详细信息,请参阅 Mutex 对象的替代项

互斥对象初始化时的初始状态为“已发出信号”。

互斥对象的存储必须驻留在驱动程序创建的设备对象的设备扩展中、驱动程序创建的控制器对象的控制器扩展中,或位于调用方分配的非分页池中。

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

要求

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

另请参阅

ExInitializeFastMutex

KeReadStateMutex

KeReleaseMutex

KeWaitForMultipleObjects

KeWaitForSingleObject