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 Objects。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 從 Windows 2000 開始提供。 |
目標平臺 | 普遍 |
標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
連結庫 | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | 任何層級 |
DDI 合規性規則 | HwStorPortProhibitedDIs(storport) |