FltAcquirePushLockSharedEx 函式 (fltkernel.h)
FltAcquirePushLockSharedEx 例程會取得呼叫線程的指定推播鎖定以進行共用存取。
語法
VOID FLTAPI FltAcquirePushLockSharedEx(
PEX_PUSH_LOCK PushLock,
ULONG Flags
);
參數
PushLock
不透明推播鎖定指標。 此指標必須由先前呼叫 FltInitializePushLock 初始化。
Flags
旗標的位掩碼,可控制鎖定的屬性。
傳回值
無。
備註
FltAcquirePushLockSharedEx 例程會取得呼叫線程的指定推播鎖定以進行共用存取。
推播鎖定類似於 ERESOURCE 結構, (也稱為資源) ,因此可以取得資源以進行共用或獨佔存取。 如需推送鎖定的詳細資訊,請參閱 FltInitializePushLock 的參考專案。
不同於ERESOURCE結構,推播鎖定無法以遞歸方式取得。 如果呼叫端已經取得獨佔存取的推送鎖定,系統將會停止回應。 如果呼叫端已經取得共用存取的推送鎖定,它可以再次接收共用存取。 不過,每個 FltAcquirePushLockShared 的呼叫都必須符合 後續對 FltReleasePushLock 的呼叫。
當呼叫端獲得給定推播鎖定的共用存取權時,取決於下列各項:
如果推送鎖定目前未擁有,則會立即將共用存取權授與目前線程。
如果已取得推送鎖定供另一個線程存取共用存取,且沒有線程正在等候對推送鎖定的獨佔存取權,則會立即將共用存取權授與給呼叫端。 如果有獨佔等候程式,呼叫端會進入等候狀態。
如果已由另一個線程取得推送鎖定以供獨佔存取,或有另一個線程正在等候獨佔存取,則目前的線程會進入等候狀態,直到取得推送鎖定為止。
規格需求
需求 | 值 |
---|---|
標頭 | fltkernel.h |
程式庫 | FltMgr.lib |