KeSrcuReadLock - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// wdm.h
VOID KeSrcuReadLock(
[in] PKE_SRCU Rcu,
[out] PKE_SRCU_LOCK Lock
);
View the official Windows Driver Kit DDI referenceNo description available.
The KeSrcuReadLock routine enters the read-side RCU critical section of a specified Sleepable Read-Copy-Update (SRCU) partition.
Rcu [in]A pointer to the SRCU instance that was previously allocated by KeSrcuAllocate.
Lock [out]A pointer to a KE_SRCU_LOCK structure that receives the lock context. This context must be passed to KeSrcuReadUnlock when exiting the critical section.
KeSrcuReadLock enters a read-side critical section, allowing the caller to safely access data protected by the SRCU partition. Multiple readers can hold read locks simultaneously, but updates must wait for all readers to exit.
Unlike regular RCU, readers can sleep while holding the read lock. Read locks can be nested within the same thread. The thread can migrate to different processors while holding the lock.
Always pair with KeSrcuReadUnlock in the same thread. The Lock parameter receives context needed for unlocking. Multiple readers can access the protected data concurrently. Writers must use KeSrcuSynchronize to wait for reader completion.
If the thread migrates to a different processor between lock and unlock, the unlock operation will use an inter-processor interrupt (IPI) to complete the unlock on the original processor.