KeInitializeMutex 函式 (wdm.h)

KeInitializeMutex 例程會初始化 Mutex 物件，並將其設定為已發出訊號的狀態。

語法

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

[out] Mutex

Mutex 物件的指標，呼叫端會為其提供記憶體。記憶體必須在32位平臺上對齊4位元組，並在64位平臺上對齊8位元組。

[in] Level

保留的。驅動程式將此設定為零。

無

為了提升效能，請使用快速 Mutex 或受防護的 mutex。如需詳細資訊，請參閱 Mutex 物件的替代方案。

mutex 物件會以已發出訊號的初始狀態初始化。

Mutex 物件的記憶體必須存留：位於驅動程式所建立裝置物件的裝置延伸模組、驅動程式所建立控制器物件的控制器延伸模組中，或是呼叫端所配置的非分頁集區中。

如需 Mutex 物件的詳細資訊，請參閱 Mutex 物件。

需求	值
最低支援的用戶端	從 Windows 2000 開始提供。
目標平台	Universal
標頭	wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫	NtosKrnl.lib
Dll	NtosKrnl.exe
IRQL	任何層級
DDI 合規性規則	HwStorPortProhibitedDIS (storport)