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) |