NdisDprAcquireSpinLock

VOID NdisDprAcquireSpinLock( IN PNDIS_SPIN_LOCK SpinLock );

NdisDprAcquireSpinLock함수는 스핀 락을 허용해서 호출자가 멀티 프로세서-safe방법으로 nonISR드라이버 함수들사이의 공유된 리소스드에 동기적으로 접근할수 있도록 한다.

매개변수

SpinLock

호출자에 의해 이미 초기화된 모호한 스핀 락의 포인트.

주석

어떤 다른 Ndis..SpinLock함수들을 호출하기전에, 닉 드라이버는 NdisAllocateSpinLock함수로 NDIS_SPIN_LOCK타입의 변수를 초기화 해야만한다. 드라이버는 사용할 스핀 락(들)을 위한 상주 저장공간을 제공해야만한다.

NdisDprAcquireSpinLock함수는 미니포트가 IRQL DISPATCH_LEVEL에서 동작될동안만 호출 될수 있는 NdisAcquireSpinLock함수의 선택적인 버전이다.

NdisDprAcquireSpinLock함수로 스핀 락을 허용한후, 호출자는 NdisDprReleaseSpinLock함수의 호출로 락을 해제해야만한다. 닉 드라이버는 각각 NdisDprAcquireSpinLock함수의 호출을 따르는 NdisDprReleaseSpinLock함수를 호출해야만 한다. 그렇지 않으면, 드라이버를 행하는 데드락이 발생한다.

NdisDprAcquireSpinLock함수로 스핀 락을 허용하는것은 NdisDprReleaseSpinLock함수로 해제되어야 한다. NdisAcquireSpinLock함수로 허용하는 스핀락은 NdisReleaseSpinLock함수로 해제되어야 한다.

드라이버는 확장된 기간(몇몇 수행이상)동안에대한 스핀 락을 잡고 있으면 절대 안된다. 25마이크로초 이상의 스핀락 소유는 시스템과 드라이버 퍼포먼스를 떨어뜨린다.

미니포트 드라이버는 미니포트의 다른 함수들이 MiniportISR 와/혹은 MiniportDisableInterrupt함수들로 공유하는 리소스들을 보호하기위해 스핀 락을 사용한다. 대신, 미니포트는 NdisMSynchronizeWithInterrupt함수를 호출하여 MiniportSynchronizeISR함수가 MiniportISR 와/혹은 MiniportDisableInterrupt함수가 사용하는 같은 DIRQL에서 그런 공유된 리소스들을 접근한다.

NdisDprAcquireSpinLock함수의 호출자는 IRQL DISPATCH_LEVEL에서 동작되어야만 한다.