ExAcquireResourceSharedLite 函式 (wdm.h)

ExAcquireResourceSharedLite 例程會取得由呼叫線程進行共用存取的指定資源。

語法

BOOLEAN ExAcquireResourceSharedLite(
  [in, out] PERESOURCE Resource,
  [in]      BOOLEAN    Wait
);

[in, out] Resource

要取得之資源的指標。

[in] Wait

指定每當無法立即取得資源時，例程的行為。如果 為 TRUE，則呼叫端會進入等候狀態，直到取得資源為止。如果 為 FALSE，則不論是否可以取得資源，例程都會立即傳回。

如果 (或取得資源) 時，ExAcquireResourceSharedLite 會傳回 TRUE。如果輸入 Wait 為 FALSE 且無法立即授與共用存取權，此例程會傳回 FALSE。

呼叫端是否獲得指定資源的共用存取權取決於下列專案：

如果資源目前未擁有，則會立即將共用存取權授與目前線程。
如果呼叫端已經取得共享或獨佔存取) 的資源 (，則目前的線程會以遞歸方式授與相同的存取類型。請注意，進行此呼叫並不會將指定資源的獨佔存取權轉換為共用存取。
如果資源目前是以另一個線程共用的方式擁有，而且沒有線程正在等候資源的獨佔存取權，則會立即將共用存取權授與給呼叫端。如果有獨佔等候程式，呼叫端會進入等候狀態。
如果資源目前由另一個線程擁有為獨佔，或有另一個線程正在等候獨佔存取，而且呼叫端尚未擁有資源的共用存取權，則目前的線程會進入等候狀態， (Wait 設定為 TRUE) 或 ExAcquireResourceSharedLite 會傳回 FALSE。

呼叫此例程之前，必須先停用一般核心 APC 傳遞。呼叫 KeEnterCriticalRegion 以停用一般核心 APC 傳遞。傳遞必須保持停用狀態，直到資源釋放為止，呼叫 KeLeaveCriticalRegion即可重新啟用它。如需詳細資訊，請參閱停用 APC。

需求	值
最低支援的用戶端	從 Windows 2000 開始提供。
目標平台	Universal
標頭	wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫	NtosKrnl.lib
Dll	NtosKrnl.exe
IRQL	<= APC_LEVEL
DDI 合規性規則	HwStorPortProhibitedDIS (storport) 、 IrqlExApcLte3 (wdm ) 、 WithinCriticalRegion (storport) 、WithinCriticalRegion (storport ) 、WithinCriticalRegion (wdm)