NdisReleaseReadWriteLock function

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(
  _Inout_ PNDIS_RW_LOCK Lock,
  _In_    PLOCK_STATE   LockState
);

Parameters

  • Lock [in, out]
    A pointer to an NDIS_RW_LOCK variable for the acquired lock to be released.

  • LockState [in]
    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

Target platform

Universal

Version

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.

Header

Ndis.h (include Ndis.h)

Library

Ndis.lib

DLL

Ndis.sys

IRQL

DISPATCH_LEVEL

DDI compliance rules

Irql_Synch_Function

See also

LOCK_STATE

NDIS_RW_LOCK

NdisAcquireReadWriteLock

NdisInitializeReadWriteLock

NdisReleaseRWLock

 

 

Send comments about this topic to Microsoft