NdisAcquireSpinLock

VOID NdisAcquireSpinLock( IN PNDIS_SPIN_LOCK SpinLock );

NdisAcquireSpinLock 함수가 스핀락을 얻으므로써 호출자는 여러 드라이버의 함수들이 공유하는 리소스로의 유일한 접근을 얻는다.

매개변수

SpinLock

호출자에 의해서 이미 초기화된 불투명한(opaque) 스핀락을 가리킨다.

주석

드라이버는 어떤 다른 스핀락 함수들이 호출되기 전에 NdisAllocateSpinLock 함수를 갖는 NDIS_SPIN_LOCK 타입의 변수들을 초기화해야만한다. 드라이버는 사용하는 스핀락을 위해 고유의 저장공간을 제공해야한다.

NdisAcquireSpinLock으로 스핀락을 얻은 후에 호출자는 NdisReleaseSpinLock을 사용해서 스핀락을 해제해야만한다. 드라이버는 각각의 NdisAcquireSpinLock 호출에 따른 NdisReleaseSpinLock을 호출해야한다. 그렇지 않으면 교착상태가 일어난다.

NdisAcquireSpinLock으로 얻은 스핀락은 NdisReleaseSpinLock으로 해제되야한다. NdisDprAcquireSpinLock으로 얻은 스핀락은 NdisDprReleaseSpinLock으로 해제되야한다.

드라이버는 결코 확장된 기간(몇몇의 명령 이상으로) 동안 스핀락을 잡고 있지 못한다. 25 마이크로초 이상 스핀락을 잡고 있으면 시스템과 드라이버 모두 그 수행이 힘들어진다.

미니포트 드라이버는 리소스를 보호하기 위해 스핀락을 사용할 수 없다. 예를 든다면 미니포트의 다른 함수들과 MiniportISR, MiniportDisableInterrupt 함수의 공유가 그러하다. 대신에 미니포트는 MiniportISR, MiniportDisableInterrupt 함수가 했던 똑같은 DIRQL에서 MiniportSynchronizeISR 함수가 그러한 공유자원에 접근하기 위해NdisMSynchronizeWithInterrupt 함수를 호출해야한다.

NdisAcquireSpinLock의 호출자는 IRQL <= DISPATCH_LEVEL에서 실행한다.