NdisAllocateSpinLock

VOID NdisAllocateSpinLock( IN PNDIS_SPIN_LOCK SpinLock );

NdisAllocateSpinLock 함수는 NDIS_SPIN_LOCK 타입의 변수를 초기화한다. 그 변수는 nonISR 드라이버 함수들 사이에서 공유된 리소스로의 접근을 동기화하기위해 사용된다.

매개변수

SpinLock

스핀락을 구현한 불투명한(opaque) 변수를 가리킨다.

주석

드라이버가 NdisAcquireSpinLock, NdisDprAcquireSpinLock, 혹은 NdisInterlockedXxx를 호출하기 전에 드라이버는 이 NdisXxx 함수의 요구된 파라미터로 전해지는 스핀락을 초기화하기 위해서 NdisAllocateSpinLock을 호출해야만한다.

NdisAllocateSpinLock을 호출한 후에 드라이버는 스핀락이 보호하는 리소스를 독점적으로 사용하기위해 NdisAcquireSpinLock을 호출할 수 있다. 리소스 접근이 완료될 때 다른 드라이버가 스핀락으로 보호되는 자원에 접근할 수 있게 하기위해 드라이버는 NdisReleaseSpinLock을 호출한다.

일반적인 규칙으로 드라이버는 다른 중요한 부분(critical sections)을 보호하기 위해 다른 락을 사용하므로써 수행능력을 향상시킬 수 있다. 그리하여 드라이버는 NdisAllocateSpinLock을 사용해서 하나 이상의 스핀락을 초기화할 것이다.

드라이버가 할당한 각각의 스핀락은 IRQL <= DISPATCH_LEVEL에서 실행되는 드라이버 함수의 동시 접근으로부터 공유 리소스의 분리된 세트를 보호한다. 예를들어 패킷의 내부 큐를 유지하는 드라이버는 큐를 보호하기 위해서 그리고 몇몇 드라이버 함수(MiniportISR, MiniportDisableInterrupt를 포함하지 않는)가 드라이버가 패킷을 처리하는 동안 접근하는 상태 변수의 세트를 보호하기 위해서 하나의 스핀락을 초기화할 것이다.

드라이버는 리소스의 동일한 서브세트를 보호하기위해 두 개의 스핀락을 사용해서는 않된다. 여러개의 스핀락은 교착상태를 빈번하게 일으키는 원인이 되기 때문이다. 드라이버가 교착상태를 방지하도록 설계되었다 하더라도 여러개의 스핀락은 드라이버의 수행능력과 I/O throughput의 성능에 반대하는 효과를 일으킨다.

미니포트 드라이버는 그것의 nonISR 함수가 MiniportISR 혹은 MiniportDisableInterrupt로 공유하는 리소스를 보호하기 위해 스핀락을 사용할 수 없다. MiniportISR 혹은 MiniportDisableInterrupt를 가지고 공유된 리소스에 접근하기 위하여 미니포트는 MiniportSynchronizeISR 함수가 DIRQL에서 리소스를 접근하도록 하기위해 NdisMSynchronizeWithInterrupt를 호출해야 한다.

드라이버가 리소스 보호를 더이상 요구하지 않을 때 드라이버는 NdisFreeSpinLock을 호출한다. 예를들어 NIC이 제거되고 드라이버가 NIC을 위해 할당했던 리소스를 해제할 때.

스핀락 해제인 "Free"와 "Release"는 애매하다. NdisFreeSpinLock은 스핀락된 메모리를 클리어하므로 더이상 스핀락이 구현되지 않는다. NdisReleaseSpinLock으로 얻었던 스핀락을 해제하는 것은 단순히 다른 작업에서 그 스핀락을 얻기위해 스레드의 실행을 허락한다. NdisAllocateSpinLock의 호출자는 어떠한 IRQL에서도 실행될 수 있다.

보통 호출자는 초기화동안 IRQL PASSIVE_LEVEL에서 실행한다.