共用方式為


ExAcquirePushLockShared 巨集 (wdm.h)

取得呼叫線程進行共用存取的指定推入鎖定。

語法

void ExAcquirePushLockShared(
   Lock
);

參數

Lock

不透明推入鎖定指標。 這個指標必須由先前呼叫 ExInitializePushLock初始化。

傳回值

沒有

言論

推送鎖定類似於 ERESOURCE 結構(也稱為資源),因為它們可以取得共用或獨佔存取權。 如需推送鎖定的詳細資訊,請參閱 ExInitializePushLock的參考專案。

不同於ERESOURCE結構,推入鎖定無法以遞歸方式取得。 如果呼叫端已經取得獨佔存取的推送鎖定,系統將會停止回應。 如果呼叫端已經取得共用存取的推送鎖定,它可以再次接收共用存取權。

若要在取得推送鎖定之後釋出,請呼叫 ExReleasePushLockShared。 每次呼叫 ExAcquirePushLockShared,都必須與後續呼叫 ExReleasePushLockShared相符。

當呼叫端獲得給定推播鎖定的共用存取權時,取決於下列各項:

  • 如果推送鎖定目前未擁有,則會立即將共用存取權授與目前的線程。

  • 如果已由另一個線程取得推送鎖定以進行共用存取,而且沒有線程正在等候推送鎖定的獨佔存取權,則會立即將共用存取權授與給呼叫端。 如果有獨佔服務員,呼叫端會進入等候狀態。

  • 如果已由另一個線程取得推送鎖定以進行獨佔存取,或有另一個線程等待獨佔存取,則目前的線程會進入等候狀態,直到取得推送鎖定為止。

呼叫此例程之前,驅動程式必須藉由呼叫 KeEnterCriticalRegion來停用一般核心 APC 傳遞。 藉由呼叫 KeLeaveCriticalRegion來釋放推播鎖定之後,可重新啟用傳遞。 如需詳細資訊,請參閱 停用 APC。

若要取得獨佔存取的推送鎖定,請呼叫 exAcquirePushLockExclusive

要求

要求 價值
最低支援的用戶端 Windows 10 版本 1809
標頭 wdm.h

另請參閱

ExInitializePushLock

KeEnterCriticalRegion

ExReleasePushLockShared

ExAcquirePushLockExclusive