MiniportISR

VOID MiniportISR( OUT PBOOLEAN InterruptRecognized, OUT PBOOLEAN QueueMiniportHandleInterrupt, IN NDIS_HANDLE MiniportAdapterContext );

MiniportISR은 드라이버의 NIC이 인터럽트들을 발생한다면은 필요한 함수이다.

매개변수

InterruptRecognized

MiniportISR은 NIC이 실제로 인터럽트를 발생할 것인지를 리턴하는 변수를 가리킨다. 만약 인터럽트가 MiniportAdapterContext로 위임된 NIC으로부터 온다는 것을 감지한다면은 이 값을 TRUE로 설정한다. 만약 NIC이 같은 버스에서 다른 장치들로 IRQ를 공유한다면은, MiniportISR은 NIC이 인터럽트가 아닌 것을 결정할 때마다 가능하다면은 빠르게 FALSE를 리턴해야 한다.

QueueMiniportHandleInterrupt

만약 MiniportHandleInterrupt 함수가 인터럽트 구동 I/O 연산을 완성하기 위해 호출되어진다면은 MiniportISR은 TRUE로 설정하는 변수를 가리킨다.

MiniportAdapterContext

드라이버가 MiniportInitialize에 의해 설정된 NIC 당 상태를 유지하는 미니포트 할당 컨텍스트 영역에 대한 핸들을 지정한다.

주석

NIC 드라이버는 MiniportISR 함수내에서 NIC이 MiniportHandleInterrupt 함수로 발생하는 각 인터럽트를 위한 I/O 연산들을 지연함으로써 가능한한 적은 작업을 해야 한다. NIC 드라이버의 ISR은 비록 MiniportISR 함수의 두개의 인스턴스들이(instantiations) SMP 기계에서 동시에 실행되어지지만은, 특히 만약 미니포트가 full-duplex 보내기와 받기를 지원한다면은, 재진입을 안한다.

인터럽트가 NIC 버스에 대해 발생할 때, 미니포트 드라이버의 MiniportISR 함수는 다음과 같은 조건들 아래서 호출되어진다:

• NIC은 그러한 버스에서 다른 장치들과 IRQ를 공유한다.

  만약 NIC이 다른 장치들과 IRQ를 공유한다면은, MiniportISR 함수는 NIC이 인터럽트를 발생할 것인지를 결정하기 위해 호출되어질 것이다. 만약 NIC이 인터럽트를 발생하지 않는다면은, MiniportISR은 즉시 FALSE를 리턴해서 인터럽트를 발생한 장치의 드라이버가 빠르게 호출되도록 한다.

• MiniportInitialize로부터 NdisMRegisterInterrupt를 호출하는 미니포트 드라이버는 MiniportISR 함수는 버스에서 모든 인터럽트를 위해 호출되어지도록 지정한다. MiniportDisable/EnableInterrupt 기능을 제공하지 않는 미니포트들은 모든 인터럽트에 의해 호출되어지는 ISR들을 가져야 한다.
• 드라이버의 MiniportInitialize 혹은 MiniportHalt 함수가 실행하는 동안 NIC에 인터럽트가 일어난다.

  MiniportISR 함수는 항상 미니포트의 NIC이 또하나의 장치와 IRQ를 공유할 것인지 혹은 MiniportISR 함수가 버스에 모든 인터럽트를 위해 호출되어질 것인지에 관계없이 그러한 경우에 호출되어진다.

MiniportISR은 InterruptRecognized와 QueueMiniportHandleInterrupt 변수의 TRUE 설정으로 제어를 리턴한 후에 응답하는 MiniportHandleInterrupt 함수는 ISR의 그것보다(DIRQL) 낮은 하드웨어 우선권(IRQL DISPATCH_LEVEL)에서 실행한다. 일반적인 규칙에서, MiniportHandleInterrupt는 NIC이 실제로 인터럽트를 발생한 것인지를 결정하는 것을 제외하고 필요하다면은 인터럽트의 타입(receive, send, reset....)를 저장하고 인터럽트 유도 I/O 연산들을 위한 모든 작업들을 해야 한다.

드라이버 개발자는 MiniportISR과 MiniportHandleInterrupt의 실행 사이에서 일대일 응답에 의존할 필요는 없다. MiniportHandleInterrupt 함수는 하나 이상의 NIC 인터럽트를 위한 I/O 처리를 다루기 위해 쓰여질 것이다. MiniportISR과 MiniportHandleInterrupt 함수들은 동시에 SMP 기계들에서 실행할 수 있다. 더우기, MiniportISR이 NIC 인터럽트를 인식하자 마자, NIC은 MiniportHandleInterrupt DPC가 그러한 연속인 인터럽트들을 위해 하나씩 실행을 위해 큐에 저장할 수 있는 동안에 또 하나의 인터럽트를 발생할 수 있다.

만약 MiniportISR은 NIC 레지스터들 혹은 상태 변수들과 같은 자원들을 또하나의 낮은 IRQL에서 실행하는 MiniportXxx 와 공유한다면은, 그러한 MiniportXxx는 NdisMSynchronizeWithInterrupt를 호출해서 드라이버의 MiniportSynchronizeISR 함수는 동기화된 멀티프로세서 안전 방식으로 그러한 공유된 자원들을 접근할 것이다. 그렇지 않다면은 공유된 자원들에 접근할 때, 그러한 MiniportXxx 함수는 가능하면은 MiniportXxx 에 의해 행해진 작업이 원상 복구되고 MiniportISR에 의해 선점될 수 있다.

미니포트는 NdisMRegisterInterrupt로 할당한 자원들을 해제하기 위해 MiniportInitialize 혹은 MiniportHalt 함수에서 NdisMDeregisterMiniport를 호출할 수 있다. NdisMDeregisterMiniport가 리턴한 후에, NDIS는 미니포트의 MiniportISR 혹은 MiniportHandleInterrupt 함수들을 호출하지 않는다.

디폴트로, MiniportISR은 특히 드라이버가 NdisMRegisterInterrupt로 인터럽트 객체를 초기화할 때 할당된 DIRQL에서 DIRQL에서 실행한다. 그러므로, MiniportISR은 단지 어떤 IRQL에서 호출하는 데 안전한 NdisRawXxx 혹은 NdisRead/WriteRegisterXxx 함수들 과 같은 NDIS 라이브러리 함수들을 호출할 수 있다.