EngInitializeSafeSemaphore 函式 (winddi.h)
EngInitializeSafeSemaphore 函式會初始化指定的安全旗號。
語法
ENGAPI BOOL EngInitializeSafeSemaphore(
[out] ENGSAFESEMAPHORE *pssem
);
參數
[out] pssem
要初始化之驅動程式配置的 ENGSAFESEMAPHORE 結構的指標。
傳回值
EngInitializeSafeSemaphore 會在成功時傳回 TRUE 。 否則會傳回 FALSE。
備註
EngInitializeSafeSemaphore 和 EngDeleteSafeSemaphore 是安全線程,在鎖定下運作,並在旗號上維護參考計數。 這可確保不論同時呼叫旗號的數目為何,都只會建立一個旗號,而且旗號存在,直到發行最後一個旗號為止。
初始化安全旗號之後,驅動程式就可以使用ENGSAFESEMAPHORE 結構的 hsem 成員呼叫 EngAcquireSemaphore 和 EngReleaseSemaphore 以進行同步處理。
當 EngInitializeSafeSemaphore 的呼叫端不再需要旗號時,應該呼叫 EngDeleteSafeSemaphore。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 可在 Windows 2000 和更新版本的 Windows 作業系統中使用。 |
目標平台 | Universal |
標頭 | winddi.h (包括 Winddi.h) |
程式庫 | Win32k.lib |
Dll | Win32k.sys |