Chapter 4 NDIS 드라이버 Lower-Edge 함수들

이것은 NDIS Upper-Edge(MiniportXxx)함수들을 익스포트하는 어떤 드라이버 위에 있는 NDIS 드라이버 내에서 실행되는 시스템-정의 함수들이다.

두가지 타입의 NDIS 드라이버들은 여기에 설명된 함수들을 가진다:

1. 여기에 설명된 ProtocolXxx함수들을 익스포트하고 후에 설명될 TDI 인터페이스를 통해 클라이언트들과 통신하는 NDIS 전송 계층 프로토콜
2. MiniportXxx함수들과 여기에 설명될 ProtocolXxx함수들을 익스포트하는 NDIS Intermediate 드라이버들

   Intermediate NDIS 드라이버들은 NIC 미니포트에게는 바인딩을 만듦으로써 그러한 Intermediate 드라이버 위해 그들 자신이 놓여 있는 상위 레벨 NDIS 드라이버들로 보인다. Intermediate NDIS 드라이버들은 NIC 드라이버를 포함해서 그것들 보다 낮게 NDIS 드라이버에게 프로토콜로 나타날 것이다. NDIS 라이브러리에 대해 그러한 Intermediate 드라이버는 프로토콜과 미니포트 드라이버로 나타날 것이다.

Driver Function Names

접두사가 Protocol인(앞에 Protocol로 시작하는) 모든 NDIS 드라이버 함수들은 다음에 나오는 참조들에서 기본적인 기능을 설명하는 메타 이름들이 주어진다.

DriverEntry 함수를 제외한, NDIS정의 드라이버 함수들은 드라이버 작성자가 선택한 이름을 가질 수 있다. 쉬운 디버깅을 위해 대부분의 시스템 제공 프로토콜들은 간단히 이 문서에서 사용된 접두사가 Protocol로 드라이버 특정 접두사로 대치된다.

윈도우 NT 커널 모드 드라이버의 초기 엔트리 포인트는 시스템에 의해 자동적으로 로드되기 위해 DriverEntry 이름을 가진다. Windows NT DriverEntry 루틴들의 기능과 일반적인 요구 사항에 대한 더 많은 정보를 위해서는 Kernel-Mode Driver Design Guide를 보라.

Calling NdisXxx Functions at Approriate IRQLs

NDIS Lower-Edge Driver Functions 디폴트로 다음의 IRQL중에 하나이다. 다음은 증가하는 우선권 순위로 보여준다:

PASSIVE_LEVEL < DISPATCH_LEVEL

IRQL PASSIVE_LEVEL에서 실행하는 어떤 드라이버 함수는 상위 우선 순위 IRQL에서 실행하는 실행 쓰레드에 의해 선점 당할 수 있다. 즉 모든 ProtocolXxx함수는 인터럽트가 발행했을 때 DIRQL에 실행하는 장치 드라이버의 ISR이나 시스템 클럭 인터럽트에 의해 선점 당할 수 있다.

각각의 다음에 나오는 DriverEntry와 ProtocolXxx 함수들의 표현(Descriptions)들은 그러한 함수들이 실행하는 디폴트 IRQL을 지정한다.(specific) 어떤 ProtocolXxx 함수들의 디폴트 IRQL 들은 효율적으로 이러한 ProtocolXxx가 호출할 수 있는 NdisXxx함수들을 제한한다. 예로 IRQL DISPATCH_LEVEL에서 실행하는 ProtocolXxx함수로부터의 NdisCopyBuffer에 대한 호출 ProtocolXxx가 스핀락을 유지하는 동안 치명적인 페이지 폴트를 야기할 수 있다.

단지 초기화와 페이지블 드라이버 코드

NDIS 프로토콜들은 NDIS_INIT_FUNCTION 매크로를 사용하여, 단지 초기화로서만 DriverEntry함수들을 표시한다.

다른 드라이버 함수들은 NDIS_PAGEABLE_FUNCTION 매크로를 사용하여 페이저블 코드로 표시할 수 있다. 그러나 드라이버 함수들은 if and only if it never runs at IRQL >= DISPATCH_LEVEL에서 페이저블 코드로 될 수 있다. 이러한 제한은 다음을 암시한다:

• 페이저블 마크된 함수는 스핀락을 얻을 수 없고 그렇게 된(that do) 다음 함수들을 호출 하지 못한다.(should not)
• 페이저블로 마크된 함수는 그 호출이 일어날 때 스핀락을 유지하는 어떤 함수에 의해 호출 되어질 수 없다.
• 페이저블로 마크된 함수는 상승된(raised) IRQL에서 실행할 수 없다.