FltAcquirePushLockShared 函式（fltkernel.h）

發行項
02/06/2025

FltAcquirePushLockShared 例程會取得呼叫線程的指定推送鎖定以供共用存取。

語法

VOID FLTAPI FltAcquirePushLockShared(
  [in, out] PEX_PUSH_LOCK PushLock
);

參數

[in, out] PushLock

類型不透明的推送鎖定指標 PEX_PUSH_LOCK。此指標必須由先前呼叫 FltInitializePushLock初始化。

傳回值

沒有。

言論

FltAcquirePushLockShared 例程會取得呼叫線程的指定推送鎖定以供共用存取。

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

不同於ERESOURCE結構，推入鎖定無法以遞歸方式取得。如果呼叫端已經取得獨佔存取的推送鎖定，系統將會停止回應。如果呼叫端已經取得共用存取的推送鎖定，它可以再次接收共用存取權。不過，FltAcquirePushLockShared 的每個呼叫都必須與後續呼叫 FltReleasePushLock相符。

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

如果推送鎖定目前未擁有，則會立即將共用存取權授與目前的線程。
如果已由另一個線程取得推送鎖定以進行共用存取，而且沒有線程正在等候推送鎖定的獨佔存取權，則會立即將共用存取權授與給呼叫端。如果有獨佔服務員，呼叫端會進入等候狀態。
如果已由另一個線程取得推送鎖定以進行獨佔存取，或有另一個線程等待獨佔存取，則目前的線程會進入等候狀態，直到取得推送鎖定為止。

由於 FltAcquirePushLockShared 會停用一般核心 APC 傳遞，因此不需要呼叫 KeEnterCriticalRegion 或 FsRtlEnterFileSystem，再呼叫 FltAcquirePushLockShared。

若要在取得推送鎖定之後釋放，請呼叫 FltReleasePushLock。 FltAcquirePushLockShared 的每個呼叫都必須與後續呼叫 FltReleasePushLock相符。

若要取得獨佔存取的推送鎖定，請呼叫 FltAcquirePushLockExclusive。

若要初始化推送鎖定，請呼叫 FltInitializePushLock。

若要刪除推送鎖定，請呼叫 FltDeletePushLock。