NdisAllocateSpinLock 함수(ndis.h)
NdisAllocateSpinLock 함수는 ISR이 아닌 드라이버 함수 간에 공유되는 리소스에 대한 액세스를 동기화하는 데 사용되는 NDIS_SPIN_LOCK 형식의 변수를 초기화합니다.
통사론
void NdisAllocateSpinLock(
[out] PNDIS_SPIN_LOCK SpinLock
);
매개 변수
[out] SpinLock
스핀 잠금을 나타내는 불투명 변수에 대한 포인터입니다.
반환 값
없음
발언
드라이버가 NdisAcquireSpinLock, NdisDprAcquireSpinLock또는 NdisInterlockedXxx 함수를 호출하기 전에 NdisAllocateSpinLock 호출하여 이러한 NdisXxx 함수에 필요한 매개 변수로 전달된 스핀 잠금을 초기화해야 합니다. 호출자는 SpinLock 변수에 대해 페이지가 없는 스토리지를 제공해야 합니다.
NdisAllocateSpinLock호출한 후 드라이버는 NdisAcquireSpinLock 호출하여 스핀 잠금이 보호하는 리소스를 단독으로 사용할 수 있습니다. 리소스 액세스가 완료되면 드라이버는 NdisReleaseSpinLock 호출하여 다른 드라이버 함수가 해당 스핀 잠금으로 보호되는 리소스에 액세스할 수 있도록 합니다.
일반적으로 성능을 향상시키려면 드라이버가 다른 잠금을 사용하여 다른 중요한 섹션을 보호해야 합니다. 따라서 드라이버는 NdisAllocateSpinLock사용하여 둘 이상의 스핀 잠금을 초기화할 수 있습니다.
드라이버가 할당하는 각 스핀 잠금은 IRQL <= DISPATCH_LEVEL 실행되는 드라이버 함수에 의한 동시 액세스로부터 개별 공유 리소스 집합을 보호합니다. 예를 들어 패킷의 내부 큐를 유지 관리하는 드라이버는 큐를 보호하기 위해 하나의 스핀 잠금을 초기화하고 다른 하나는 MiniportInterrupt 포함하지 않고 여러 드라이버가 작동하는 상태 변수 집합을 보호할 수 있습니다. miniportDisableInterruptEx 함수를 드라이버가 패킷을 처리하는 동안 액세스합니다.
NdisAcquireSpinLock IRQL을 DISPATCH_LEVEL 발생시키고 이전 IRQL을 스핀 잠금에 저장합니다. 스핀 잠금을 해제하면 IRQL이 스핀 잠금에 저장된 값으로 설정됩니다. NDIS는 때때로 PASSIVE_LEVEL 드라이버를 입력하기 때문에 다음 코드에서 문제가 발생할 수 있습니다.
NdisAcquireSpinLock(A);
NdisAcquireSpinLock(B);
NdisReleaseSpinLock(A);
NdisReleaseSpinLock(B);
드라이버는 다음과 같은 이유로 이 시퀀스의 스핀 잠금에 액세스해서는 안 됩니다.
- NdisReleaseSpinLock(A)와 NdisReleaseSpinLock(B) 사이에 코드가 DISPATCH_LEVEL 대신 PASSIVE_LEVEL 실행 중이며 부적절한 중단이 발생할 수 있습니다.
- NdisReleaseSpinLock (B)를후 코드가 DISPATCH_LEVEL 실행 중이므로 IRQL_NOT_LESS_OR_EQUAL 중지 오류로 인해 호출자가 훨씬 나중에 오류가 발생할 수 있습니다.
미니포트 드라이버는 스핀 잠금을 사용하여 ISR이 아닌 함수가 MiniportInterrupt 공유하는 리소스를 보호할 수 없습니다. MiniportDisableInterruptEx 함수입니다. MiniportInterrupt 또는 MiniportDisableInterruptEx 함수와 공유되는 리소스에 액세스하려면 미니포트 드라이버가 호출해야 합니다. NdisMSynchronizeWithInterruptEx MiniportSynchronizeInterrupt 함수는 DIRQL에서 해당 리소스에 액세스합니다.
예를 들어 NIC가 제거되고 드라이버가 해당 NIC에 할당된 리소스를 해제하는 경우 드라이버가 더 이상 리소스 보호를 필요로 하지 않는 경우 드라이버는 NdisFreeSpinLock호출합니다.
스핀 잠금을 해제하고 스핀 잠금을 해제하는 것은 잠재적으로 혼란스러울 수 있습니다. NdisFreeSpinLock 더 이상 스핀 잠금을 나타내지 않도록 SpinLock 메모리를 지웁니다. NdisReleaseSpinLock 사용하여 획득한 스핀 잠금을 해제하면 다른 실행 스레드가 해당 스핀 잠금을 획득할 수 있습니다.
NDIS 스핀 잠금을 획득하고 해제하는 방법에 대한 자세한 내용은 네트워크 드라이버 동기화 및 알림을 참조하세요.
NdisAllocateSpinLock 호출자는 모든 IRQL에서 실행할 수 있습니다. 일반적으로 호출자는 초기화 중에 IRQL = PASSIVE_LEVEL 실행됩니다.
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista에서 NDIS 6.0 및 NDIS 5.1 드라이버(NdisAllocateSpinLock(NDIS 5.1 참조)에 대해 지원됩니다. Windows XP에서 NDIS 5.1 드라이버(NdisAllocateSpinLock(NDIS 5.1 참조)에 대해 지원됩니다. |
| 대상 플랫폼 | 보편적 |
| 헤더 | ndis.h(Ndis.h 포함) |
| 라이브러리 | Ndis.lib |
| IRQL | 모든 수준(설명 섹션 참조) |
| DDI 규정 준수 규칙 | SpinLockDpr(ndis), SpinLockDprRelease(ndis), SpinlockRelease(ndis) |