NdisMRegisterInterrupt
NDIS_STATUS
NdisMRegisterInterrupt(
OUT PNDIS_MINIPORT_INTERRUPT Interrupt,
IN NDIS_HANDLE MiniportAdapterHandle,
IN UINT InterruptVector,
IN UINT InterruptLevel,
IN BOOLEAN RequestIsr,
IN BOOLEAN SharedInterrupt,
IN NDIS_INTERRUPT_MODE InterruptMode
);
|
NdisMRegisterInterrupt는 NIC 드라이버의 MiniportIsr 과 MiniportHandleInterrupt 함수사이에 이미 NdisMRegisterMiniport로 등록된, 맵핑을 설정하고 NIC이 인터럽트하는 버스 관련 벡터와 레벨을 설정한다.
매개변수
- Interrupt
- NdisMRegisterInterrupt가 초기화하고 NdisMSynchronizeWithInterrupt에 대한 계속적인 호출에서 미니포트가 사용하는 핸들을 리턴하는 불분명한 인터럽트 객체를 포함하는 호출자 할당 상주 메모리를 가리킨다.
- MiniportAdapterHandle
- MiniportIntialize에 대한 입력 핸들을 가리킨다.
- InterruptVector
- NIC에 의해 사용된 버스 관련 벡터 넘버를 지정한다.
- InterruptLevel
- 인터럽트를 위한 버스 관련 DIRQL를 지정한다. 이 값은 거의 항상 InterruptVector의 것과 같다.
- RequestIsr
- 만약 MiniportIsr 함수가 NIC이 인터럽트할 때마다 호출되어진다면은 TRUE를 지정한다. 만약 NIC이 I/O 버스에 있는 다른 장치들과 인터럽트들을 공유하다면은, 이 매개변수는 TRUE로 설정되어질 것이다.
- SharedInterrupt
- 만약 I/O 버스에 있는 다른 장치들이 이러한 인터럽트 라인들을 사용할 수 있다면은 TRUE를 지정한다. 만약 이 매개변수가 FALSE로 설정된다면은 또 하나의 장치는 이미 레지스트리내에 주어진 인터럽트 벡터를 요구한다면, NdisMRegisterInterrupt는 실패할 것이다.
- InterruptMode
- NIC이 다음과 같은 값들 중에 하나로서 발생한 인터럽트 타입을 지정한다.
- NdisInterruptLatched
- 인터럽트 라인에서 낮은데서 높은 곳으로 전이에 의해 인터럽트들이 트리거된다.
- NdisInterruptLevelSensitive
- 인터럽트들은 인터럽트 라인이 assert된 동안은 활성화된다.
리턴값
NdisMRegisterInterrupt는 다음과 같은 하나를 리턴할 수 있다. :
- NDIS_STATUS_SUCCESS
- NDIS는 인터럽트 객체를 초기화하고 유효한 Interrupt 핸들을 리턴하고 만약 NIC이 IRQ를 공유하지 않는다면은 주어진 인터럽트 벡터와 같은 NIC을 위해 레지스트리내에 하드웨어 자원들을 요구하고 MiniportISR(혹은 MiniportDisableInterrupt)와 인터럽트가 NdisMRegisterInterrupt에 대한 호출에서 요구된 것이 발생할 때 호출되어지는 관련된 MiniportHandleInterrupt 함수들을 설정한다.
- NDIS_STATUS_RESOURCE_CONFLICT
- 레지스트리내에 벡터 혹은 레벨를 요구하는 시도가 가능하면은 드라이버가 이미 장치를 위해 요구했기 때문에 실패한다. NdisMRegisterInterrupt는 만약 이것이 발생한다면은 에러를 로그한다.
- NDIS_STATUS_RESOURCES
- NDIS는 NIC을 위해 레지스트리내에 자원들을 요구하는 충분한 메모리를 할당할 수 없다.
- NDIS_STATUS_FAILURE
- 인터럽트 객체를 초기화하는 시도가 레지스트리내에서 InterruptVector 혹은 InterruptLevel에 또 하나의 드라이버의 우선 요구 때문에 실패한다.
주석
NIC 드라이버는 만약 NIC이 인터럽트들을 발생한다면은 MiniportInitialize 함수로부터 NdisMRegisterInterrupt를 호출해야 한다. 인터럽트들을 발생안하는 NIC의 드라이버는 NdisMRegisterInterrupt 대신에 NdisMInitializeTimer 와 NdisMSetPeriodicTimer 함수를 호출한다.
MiniportInitialize 함수는 NdisMRegisterInterrupt를 호출하기 전에 NdisMSetAttributes 혹은 NdisMSetAttributesEx 함수를 호출해야 한다.
버스 관련 값들을 얻은 MiniportInitialize 함수는 레지스트리로부터 혹은 버스 타입 특정 NdisXxx 구성 함수를 호출함으로써 NdisMRegisterInterrupt에게 전달되어진다.
만약 NdisMRegisterInterrupt에 대한 호출이 실패한다면은, MiniportInitialize 함수는 이미 NIC을 위해 할당된 모든 자원들을 해제해야 하고 그러한 NIC을 위해 초기화가 실패한다.
NdisMRegisterInterrupt 함수는 InterruptVector(카드가 시스템에 인터럽트를 위해 assert한 인터럽트 라인)와 InterruptLevel(시스템에 의해 할당된 그러한 인터럽트의 하드웨어 우선권 즉 DIRQL) 사이에 구별된다. 항상, 이러한 값들은 만약 드라이버 개발자가 특정 NIC을 위해 다르다는 것을 알지 못하거나 미니포트가 현 플랫폼에서 자원들을 공유하는 하나 이상의 NIC을 제어하지 않는다면은 같은 값으로 여겨질 수 있다.
만약 NIC이 I/O 버스에서 다른 장치들과 공유한다면은, NdisMRegisterInterrupt의 호출자는 SharedInterrupt 와 RequestIsr 매개변수들을 TRUE로 설정해야 한다. 그러한 NIC 드라이버의 MiniportIsr 함수는 NIC을 위한 인터럽트가 나타나지 않을 때 호출되어질 수 있다. 이러한 환경에서, MiniportIsr은 가능하다면은, 인터럽트가 인식되지 않거나 NIC에서 가능한 인터럽트들을 leaves해야 한다는 것을 인디케이트하는 FALSE를 리턴한다.
인터럽트들이 NIC에서 인에이블될 때, 드라이버의 MiniportIsr 함수는 초기화하는 동안 NdisMRegisterInterrupt에 대한 성공적인 호출에서 이어(following) 각 때마다(any time) 호출되어질 수 있다. 그러한 드라이버의 MiniportInitialize 함수는 드라이버가 인터럽트들을 다루는 데 필요로하는 모든 상태를 설정할 때까지 NdisMRegisterInterrupt를 호출할 필요가 없다. MiniportHandleInterrupt 함수는 만약 드라이버의 MiniportInitialize 함수가 현재 실행되고 있고 인터럽트가 발생한다면은 연속된 실행을 위해 큐에 저장되지 않는다.
IRQ를 공유하지 않는 대부분의 NIC 드라이버에 대해서 MiniportISR 함수는 드라이버가 초기화하는 동안을 제외해서는 드물게 실행되어진다.(애매) 그러한 미니포트는 MiniportInitialize 함수가 NdisMRegisterInterrupt 함수를 호출할 때, RequstIsr를 FALSE로 설정하고 그러한 드라이버는 MiniportDisableInterrupt 함수를 가지고 그리고 가능하다면은 MiniportEnableInterrupt 함수를 가진다. NDIS 라이브러리는 그리고 나서 인터럽트가 NIC에서 발생할 때 드라이버의 MiniportDisableInterrupt 함수를 호출하고 드라이버의 MiniportHandleInterrupt 함수는 인터럽트를 위해 대부분의 I/O 처리를 한다. MiniportHandleInterrupt는 제어를 리턴하기 전에, NDIS는 MiniportEnableInterrupt함수를 호출하거나 MiniportHandleInterrupt 함수는 NIC에 대해 다시 인터럽트들을 가능하게 한다.
ISR를 가진 미니포트는 NdisMRegisterInterrupt를 호출할 때 RequestIsr를 TRUE로 설정하거나 혹은 그렇지 않은지간에 NDIS는 운영체제에게 다른 장치들로부터 인터럽트들은 블럭되지 않기 위해 인터럽트를 알린다.(acknowledges)
만약 미니포트가 NdisMRegisterInterrupt를 호출할 때 RequestIsr를 TRUE로 설정한다면은 네트워크 인터페이스 카드의 상태를 설정함으로써 NIC에 인터럽트를 dismiss 해야 하고 그래서 NIC이 더 이상 인터럽트를 assert한다. 인터럽트들이 인터럽트의 dismissal 후에(following) NIC에서 인에이블 상태로 남을 수 있거나 혹은 그들은 드라이버 설계에 의존하여 불가능한 상태로 될 수 있다. 그러한 dismissal의 타이밍은 드라이버가 다음과 같은 NdisMRegisterInterrupt를 호출할 때, 지정된 InterruptMode에 의존한다.
- NdisInterruptLevelSensitive 인터럽트에 대해, MiniportISR은 NIC이 그러한 인터럽트를 발생한 것처럼 각 인터럽틑 dismiss 해야 한다. 그렇지 않으면은, 인터럽트는 MiniportISR이 제어를 리턴하자 마자, NIC에게 다시 assert되어진다. 만약 MiniportISR이 NIC이 특정 인터럽트를 발생하지 않는 것을 결정한다면은, 같은 버스에 있는 다른 장치들을 위한 ISR들이 즉시 실제 그러한 인터럽트가 발생하는 장치에 대해 인터럽트를 dismiss하기 위해 호출되어질 수 있게 가능하다면은 빨리 FALSE로 제어를 리턴해야 한다.
- NdisInterruptLatched 인터럽트들을 위해, NIC에서 인터럽트를 dismiss 하는 것은 공유된 인터럽트들을 위해 time-critical 하지 않다. 만약 미니포트가 MiniportISR에 대한 각 호출이 관련된 MiniportHandleInterrupt 함수에 대한 연속된 호출을 야기하도록 설계되어진다면은, MiniportHandleInterrupt 함수는 NIC에서 인터럽트를 dismiss 할 수 있다. 대체적으로, 그러한 드라이버는 NdisMRegisterInterrupt 함수를 호출할 때 RequestIsr를 FALSE로 설정할 수 있고 MiniportDisableInterrupt 함수를 제공할 수 있다. 이 함수는 만약 MiniportHalt 혹은 MiniportInitialize 함수가 현재 실행하고 있지 않다면은 MiniportISR 대신에 호출되어질 것이다.
미니포트가 full-duplex 보내기와 받기를 제공할 때, NDIS는 보내기들을 위해 MiniportISR 혹은 MiniportDisableInterrupt 함수에 대한 호출들을 직렬화한다. NDIS는 다르게 인터럽트들을 야기할 수 있는 모든 다른 연산들을 위해 MiniportISR 혹은 MiniportDisableInterrupt 함수에 대한 호출들을 직렬화한다. MiniportReset 함수에 대한 호출들은 동기화된 그리고 동기화이다.; NDIS는 full-duplex 미니포트내에서 모든 다른 코드 경로들이 장치 리셋 연산이 발생하는 동안 진입되는 것을 막는다.
만약 미니포트가 full-duplex 보내기들 받기들을 지원하지 않는다면은, NDIS는 미니포트가 제어하는 어떤 NIC을 위해 MiniportISR 혹은 MiniportDisableInterrupt 함수에 대한 모든 호출들을 직렬화한다. 그러한 드라이버의 MiniportISR 혹은 MiniportDisableInterrupt 함수가 특정 NIC 인터럽트를 처리하는 동안에, SMP 기계에서 또 하나의 프로세서에서 같은 NIC으로부터 두 번째 인터럽트를 처리하기 위해 호출되지 않을 것이다.
그러나, 한 장치 이상을 제어하는 어떤 드라이버의 ISR(혹은 MiniportDisableInterrupt 함수)은 만약 그러한 드라이버의 장치들이 거의 동시에 인터럽트를 발생하는 것이 발생하고 인터럽트들이 NIC에 의해 인에이블된다면은 SMP 기계에서 동시에 실행할 수 있다.
만약 인터럽트가 또 하나의 드라이버 함수가 MiniportISR 혹은 MiniportDisableInterrupt 함수로부터 접근될 수 있는 자원들을 접근하는 동안 발생할 수 있다면은 다른 함수는 드라이버 제공 MiniportSynchronizeISR 함수가 DIRQL에서 공유된 자원들을 접근할 수 있도록 NdisMSynchronizeWithInterrupt 함수를 호출해야 한다.
NdisMRegisterInterrupt 의 호출자들은 IRQL PASSIVE_LEVEL에서 실행한다.
|