NdisReleaseReadWriteLock function (ndis.h)

Article
04/18/2022

The NdisReleaseReadWriteLock function releases a lock that was acquired in a preceding call to NdisAcquireReadWriteLock.

Note The read-write lock interface is deprecated for NDIS 6.20 and later drivers, which should use NdisReleaseRWLock instead of NdisReleaseReadWriteLock.

Syntax

void NdisReleaseReadWriteLock(
  [in, out] PNDIS_RW_LOCK Lock,
  [in]      PLOCK_STATE   LockState
);

Parameters

[in, out] Lock

A pointer to an NDIS_RW_LOCK variable for the acquired lock to be released.

[in] LockState

A pointer to an opaque LOCK_STATE variable that tracks the state of the lock. This variable exists in the interval between the time the caller acquires and releases the lock.

Return value

None

Remarks

A driver must initialize a lock before calling any other NdisXxxReadWriteLock function that is used to acquire or release read or write access to the resources that are protected by that lock. The NdisInitializeReadWriteLock function is used to initialize a lock.

A driver must call the NdisAcquireReadWriteLock function to acquire a lock before the driver can call NdisReleaseReadWriteLock. Each call to NdisAcquireReadWriteLock requires a reciprocal call to NdisReleaseReadWriteLock.

NdisReleaseReadWriteLock restores the original IRQL that was used by its caller before the call to NdisAcquireReadWriteLock was made.

Requirements

Requirement	Value
Minimum supported client	Deprecated for NDIS 6.20 and later drivers, which should use NdisReleaseRWLock instead of NdisReleaseReadWriteLock. Supported for NDIS 6.0 and NDIS 5.1 drivers (see NdisReleaseReadWriteLock (NDIS 5.1)) in Windows Vista. Supported for NDIS 5.1 drivers (see NdisReleaseReadWriteLock (NDIS 5.1)) in Windows XP.
Target Platform	Universal
Header	ndis.h (include Ndis.h)
Library	Ndis.lib
DLL	Ndis.sys
IRQL	DISPATCH_LEVEL
DDI compliance rules	Irql_Synch_Function(ndis)