ExAcquirePushLockShared 巨集 (wdm.h)
取得呼叫線程進行共用存取的指定推入鎖定。
語法
void ExAcquirePushLockShared(
Lock
);
參數
Lock
不透明推入鎖定指標。 這個指標必須由先前呼叫 ExInitializePushLock初始化。
傳回值
沒有
言論
推送鎖定類似於 ERESOURCE 結構(也稱為資源),因為它們可以取得共用或獨佔存取權。 如需推送鎖定的詳細資訊,請參閱 ExInitializePushLock的參考專案。
不同於ERESOURCE結構,推入鎖定無法以遞歸方式取得。 如果呼叫端已經取得獨佔存取的推送鎖定,系統將會停止回應。 如果呼叫端已經取得共用存取的推送鎖定,它可以再次接收共用存取權。
若要在取得推送鎖定之後釋出,請呼叫 ExReleasePushLockShared。 每次呼叫 ExAcquirePushLockShared,都必須與後續呼叫 ExReleasePushLockShared相符。
當呼叫端獲得給定推播鎖定的共用存取權時,取決於下列各項:
如果推送鎖定目前未擁有,則會立即將共用存取權授與目前的線程。
如果已由另一個線程取得推送鎖定以進行共用存取,而且沒有線程正在等候推送鎖定的獨佔存取權,則會立即將共用存取權授與給呼叫端。 如果有獨佔服務員,呼叫端會進入等候狀態。
如果已由另一個線程取得推送鎖定以進行獨佔存取,或有另一個線程等待獨佔存取,則目前的線程會進入等候狀態,直到取得推送鎖定為止。
呼叫此例程之前,驅動程式必須藉由呼叫 KeEnterCriticalRegion來停用一般核心 APC 傳遞。 藉由呼叫 KeLeaveCriticalRegion來釋放推播鎖定之後,可重新啟用傳遞。 如需詳細資訊,請參閱 停用 APC。
若要取得獨佔存取的推送鎖定,請呼叫 exAcquirePushLockExclusive。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 10 版本 1809 |
標頭 | wdm.h |