NdisInitializeReadWriteLock

VOID NdisInitializeReadWriteLock( IN PNDIS_RW_LOCK Lock );

NdisInitializeReadWriteLock함수는 NDIS_RW_LOCK타입의 변수를 초기화 한다. NDIS_RW_LOCK변수는 한번에 하나의 비ISR드라이버 스레드에대한 공유된 자원의 쓰기접근제한을위해 사용된다. 이 NDIS_RW_LOCK는 여러개의 비ISR드라이버 스레드들이 동시에 그러한 리소스들에 접근할수 있도록한다. 그런 읽기 접근은 쓰기 접근동안에 허용되지 않는다.

매개변수

Lock

락을 나타내는 모호한 변수의 포인터. 호출자는 이 락을 비ISR드라이버 스레드들사이의 공유된 리소스의 쓰기 혹은 읽기 접근을 얻기위해 이 락을 사용할수 있다.

주석

NdisInitializeReadWriteLock함수에게 넘겨지는 락 포인터는 모든 다른 Ndis..ReadWriteLock함수들에게 필요한 파라미터이다.

드라이버가 리소스들에대한 쓰기 혹은 읽기 접근을 얻기위해 NdisAcquireReadWriteLock함수를 호출하기전에, 드라이버는 그 리소스들과 관계된 락을 초기화 하기위해 NdisInitializeReadWriteLock함수를 호출해야만 한다. 호출자는 Lock의 변수에 비페이지화된 저장공간을 제공해야만한다.

NdisInitializeReadWriteLock함수의 호출후, 드라이버는 그 리소스에대한 쓰기 혹은 읽기 접근을 얻기위해 NdisAcquireReadWriteLock함수를 호출할수 있다. 단지 한번에 하나의 비ISR드라이버 스레드만이 그 리소스에대한 쓰기 접근을 얻을수 있다. 하나의 비ISR스레드가 쓰기접근을 가질때, 다른 비ISR스레드에의한 모든 읽기와 쓰기 접근들은 그 쓰기 접근소유자가 락을 해제 할때까지 기다려야만한다. 그러나 만약 비ISR스레드가 읽기접근을 갖는다면, 다른 비ISR스레드들은 동시에 일기 접근을 허용한다.

일기에대해 빈번하게 접근되어지고 쓰기에대해 드물게 접근되어지는 리소스에대해 이 타입의 락을 초기화 하고 사용하라.

리소스접근이 완료될때, 드라이버는 NdisReleaseReadWriteLock함수를 호출한다.

드라이버가 초기화하는 각 락은 다음중 하나를 행한다.:

• IRQL <= DISPATCH_LEVEL에서 동작하는 드라이버 스레드들에의해 동시에 일어나는 읽기, 쓰기접근으로부터 공유된 리소스들의 분리된 설정을 보호한다.
• IRQL <= DISPATCH_LEVEL에서 동작하는 드라이버 스레드들에의해 동시에 읽기접근을 하기위한 공유된 리소스들의 분리된 설정을 드러낸다.