KeInitializeMutex 函数 (wdm.h)

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

语法

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

参数

[out] Mutex

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

[in] Level

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

返回值

没有

言论

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

互斥体对象使用信号的初始状态进行初始化。

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

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

要求

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

另请参阅

ExInitializeFastMutex

KeReadStateMutex

KeReleaseMutex

KeWaitForMultipleObjects

KeWaitForSingleObject