fltAcquirePushLockSharedEx 函数 (fltkernel.h)
FltAcquirePushLockSharedEx 例程获取给定的推送锁,以便由调用线程进行共享访问。
语法
VOID FLTAPI FltAcquirePushLockSharedEx(
PEX_PUSH_LOCK PushLock,
ULONG Flags
);
参数
PushLock
不透明的推送锁定指针。 此指针必须已通过先前对 FltInitializePushLock 的调用进行初始化。
Flags
控制锁属性的标志的位掩码。
返回值
无。
备注
FltAcquirePushLockSharedEx 例程获取给定的推送锁,以便由调用线程进行共享访问。
推送锁类似于 ERESOURCE 结构 (也称为资源) ,因为它们可以获取共享或独占访问。 有关推送锁的详细信息,请参阅 FltInitializePushLock 的参考条目。
与 ERESOURCE 结构不同,推送锁不能以递归方式获取。 如果调用方已获取独占访问的推送锁,系统将挂起。 如果调用方已获取共享访问的推送锁,则可以再次接收共享访问。 但是,每次对 FltAcquirePushLockShared 的 调用都必须与后续对 FltReleasePushLock 的调用相匹配。
何时向调用方授予对给定推送锁的共享访问权限取决于以下内容:
如果推送锁当前是无所有者的,则会立即向当前线程授予共享访问权限。
如果另一个线程已获取推送锁以便进行共享访问,并且没有线程正在等待对推送锁的独占访问,则会立即向调用方授予共享访问权限。 如果有排他服务员,则调用方将进入等待状态。
如果推送锁已被另一个线程获取独占访问,或者如果有另一个线程等待独占访问,则当前线程将进入等待状态,直到可以获取推送锁。
要求
要求 | 值 |
---|---|
Header | fltkernel.h |
Library | FltMgr.lib |