NdisAcquireReadWriteLock

VOID NdisAcquireReadWriteLock( IN PNDIS_RW_LOCK Lock, IN BOOLEAN fWrite, IN PLOCK_STATE LockState );

NdisAcquireReadWriteLock함수는 호출자가 드라이버 스레드들 사이에 공유된 리소스들에 읽기혹은 쓰기 접근을 사용하는 락을 허용한다.

매개변수

Lock

락을 나타내는 모호한 변수의 포인터. 호출자는 공유리소스에 접근하기위해 이락을 사용할수있다.

fWrite

불린형 변수를 나타낸다. 만약 변수가 TRUE면, 이함수는 공유 리소스에 쓰기 접근으로 제공되고, 만약 FALSE이면, 이함수는 읽기 접근으로 제공된다.

LockState

락의 상태를 나타내는 모호한 변수의 포인터. 이 변수는 호출자가 락을 허용하거나 해제하는 시간 사이의 인터벌에서 존재한다. 호출자는 같은 nonISR드라이버 스레드로부터 락을 허용하도록 하는 각각의 시도에대한 LOCK_SATAE타입의 다른 변수를 사용해야한다.

주석

드라이버가 어떤 다른 Ndis..ReadWriteLock함수를 호출하기전에 드라이버는 NdisInitializeReadWriteLock함수를 사용해 NDIS_RW_LOCK변수를 초기화해야한다. 드라이버는 사용할 락들에 대한 존재하는 저장소를 제공해야만 한다.

NdisAcquireReadWriteLock함수의 사용에의한 락의 허용후, 호출자는 NdisReleaseReadWriteLock함수를 사용해 락을 해제해야만 한다. 락의 레퍼런스 카운터를 줄이기위해, 드라이버는 NdisAcquireReadWriteLock함수의 각각 호출에대해 NdisReleaseReadWriteLock함수를 호출해야만 한다.

드라이버 스레드들 사이의 공유된 리소스들을 수정하기위해, 드라이버 스레드는 쓰기 락을 허용해야만 한다. 이러한 리소스들을 간단히 모니터링을 위해, 드라이버 스레드는 읽기전용 락을 허용해야만한다. 읽기접근은 스핀락들에대한 interlocked연산혹은 컨텐츠를 요구한다. 읽기전용 접근을 사용하는것은 운영체제와 드라이버의 좋은 퍼포먼스를 유지하는데 도움을 준다.

드라이버 스레드는 25밀리초이상동안 쓰기 락을 결코 잡아서는 안된다. 연장된 기간동안에대한 쓰기접근을 잡고있는것은 운영체제와 드라이버의 퍼포먼스를 떨어뜨린다.

접근 업그레이드는 읽기에대해 얻어진 쓰기에대한 같은 락을 얻기위해 사용되어질수 있다. 그러나 리소스 접근을 업그레이드를 위한 접근 업그레이드의 사용에 있어 주의를 해야한다. 예를들어, 드라이버는 처음 읽기 락을 허용하도록 프로그램됐다. 이 드라이버가 많은 반복후 쓰기에 대해 이 락을 허용하는 함수를 호출하도록 프로그램되었다고 가정해라. 이 접근 업그레이드는 함수 호출내에서 버려지기때문에, 이드라이버는 이러한 리소스들이 함수 호출의 결과로 변화될것이라는것을 예상하고 프로그램 되어야한다.

접근 격하(DOWNGRADE)는 지원되지않는다. 접근 격하는 쓰기에대해 얻은 읽기에대한 같은 락을 얻는데 사용된다.

드라이버 쓰레드는 읽기 락을 쓰기 락으로 허용하는 업그레이드없이 공유리소스를 수정할수있다. 그러나, 운영체제와 NDIS가 이연산을 허용하더라도, 에러를 초래한다.

드라이버는 다른 함수들이 MiniportISR and/or MiniportDisableInterrupt함수들로 공유하는 읽기 혹은 쓰기 접근으로부터의 리소스들을 보호하기위한 락을 사용할수없다. 대신에, 드라이버는 MiniportSynchronizeISR함수가 MiniportISR and/or MiniportDisableInterrupt함수가 하는 같은 DIRQL에서의 공유된 리소스들을 접근하기위해 NdisMSynchronizeWithInterrupt 함수를 호출한다.

NdisAcquireReadWriteLock함수의 호출자는 IRQL <= DISPATCH_LEVEL에서 동작한다.