ExAcquireResourceSharedLite 函数 (wdm.h)

ExAcquireResourceSharedLite 例程获取由调用线程进行共享访问的给定资源。

语法

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

参数

[in, out] Resource

指向要获取的资源的指针。

[in] Wait

指定每当无法立即获取资源时例程的行为。 如果 TRUE,则调用方将进入等待状态,直到获取资源。 如果 FALSE,则无论是否可以获取资源,例程都会立即返回。

返回值

调用方可以通过调用 ExReleaseResourceLiteExReleaseResourceForThreadLite释放资源。

ExAcquireResourceSharedLite 在获取资源时(或何时)返回 true。 如果输入 WaitFALSE 且无法立即授予共享访问权限,则此例程将返回 FALSE

言论

是否或何时向调用方提供对给定资源的共享访问权限取决于以下情况:

  • 如果资源当前未拥有,则立即向当前线程授予共享访问权限。

  • 如果调用方已获取资源(用于共享或独占访问),则以递归方式向当前线程授予相同类型的访问。 请注意,进行此调用不会将调用方对给定资源的独占访问权限转换为共享访问。

  • 如果资源当前由另一个线程共享,并且没有线程正在等待对资源的独占访问,则立即向调用方授予共享访问权限。 如果存在排他服务员,则调用方将进入等待状态。

  • 如果资源当前由另一个线程拥有为独占,或者有另一个线程正在等待独占访问,并且调用方尚未具有对资源的共享访问权限,则当前线程要么处于等待状态(Wait 设置为 TRUE),或者 ExAcquireResourceSharedLite 返回 FALSE

在调用此例程之前,必须禁用正常的内核 APC 传递。 通过调用 KeEnterCriticalRegion禁用正常的内核 APC 传递。 在释放资源之前,传递必须保持禁用状态,此时可以通过调用 KeLeaveCriticalRegion重新启用它。 有关详细信息,请参阅 禁用 APC

要求

要求 价值
最低支持的客户端 从 Windows 2000 开始可用。
目标平台 普遍
标头 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)

另请参阅

ExAcquireResourceExclusiveLite

ExAcquireSharedStarveExclusive

ExAcquireSharedWaitForExclusive

ExConvertExclusiveToSharedLite

ExGetExclusiveWaiterCount

ExGetSharedWaiterCount

ExInitializeResourceLite

ExIsResourceAcquiredSharedLite

ExReinitializeResourceLite

ExReleaseResourceForThreadLite