미니포트 드라이버의 DriverEntry

NDIS_STATUS

  DriverEntry(

    IN PVOID  Argument1,

    IN PVOID  Argument2

    );

DriverEntry는 시스템이 어떤 NDIS 드라이버에서 처음 호출하는 필요한 함수이다.

매개변수

Argument1
시스템 제공 매개변수를 가리킨다. 윈도우즈 NT 드라이버들에서, 이것은 단지 MiniportXxx 함수들에게 익스포트하는 어떤 NDIS 드라이버에 불투명한(opaque) 드라이버 객체를 가리킨다.

Argement2
두번째 시스템 제공 매개변수를 가리킨다. 윈도우즈 NT 드라이버들에서, 이것은 단지 MiniportXxx 함수들에게 익스포트하는 어떤 NDIS 드라이버에 불투명한 레지스트리 경로명을 가리킨다.
리턴값

DriverEntry는 NdisMRegisterMiniport 혹은 NdisIMRegisterLayeredMiniport에 의해 리턴된 값을 리턴한다.

주석

NDIS miniports와 intermediate 드라이버들은 DriverEntry 함수들에서 두가지 기본적인 일들을 실행한다:

  1. 드라이버는 미니포트로서 막 등록하려고 할 때 NDIS 라이브러리에게 알리기 위해(notify) NdisMInitializeWrapper를 호출한다.

    NDIS는 드라이버를 추적(track)하는데 필요한 상태를 설정하고 드라이버가 NdisXxx 구성과 초기화 함수들에 대한 계속적인 호출을 위해 저장한 NdisWrapperHandle를 리턴한다.

  2. 적당한 버전 넘버와 드라이버 제공 MiniportXxx 함수들을 위한 엔트리 포인트들을 가진 NDIS_MINIPORT_CHARACTERISTICS 구조체를 채우고 나서 NdisMRegisterMiniport 혹은 NdisIMRegisterLayeredMiniport를 호출한다.

    항상, NIC 드라이버들은 NdisMRegisterMiniport를 호출한다. intermediate 드라이버들은 단지 MiniportXxx 함수들을 익스포트한다. 항상, NDIS intermediate 드라이버들은 드라이버가 ProtocolBindAdapter 함수로부터 NdisIMInitializeDeviceInstance 함수를 호출할때까지 효율적으로 드라이버 가상 NIC의 초기화를 지연하는 NdisIMRegisterLayeredMiniport를 호출한다.

DriverEntry는 NDIS 라이브러리가 자신의 저장 공간에 관련된 정보를 복사할 때 스택에 NDISXXX_MINIPORT_CHARACTERISTICS 구조체를 할당할 수 있다. DriverEntry는 멤버들에 어떤 드라이버 제공 값들을 설정하기 전에 이 구조체에 대한 메모리를 NdisZeroMemory를 사용해서 클리어해야 한다. 현 MajorNdisVersion은 0x04와 현 MinorNdisVersion은 0x00이다. 특성 구조체 내에 각 XxxHandler 멤버내에서 DriverEntry는 드라이버 제공 MiniportXxx 함수의 이름을 설정해야 하고 아니면은 멤버를 NULL로 설정해야 한다.

NdisMRegisterMiniport를 호출하는 것은 NdisMRegisterMiniport의 컨텍스트내에서 실행하는 드라이버의 MiniportInitialize 함수를 야기시킨다. NdisIMRegisterLayeredMiniport를 호출하는 것은 드라이버가 NdisIMInitializeDeviceInstance를 호출할 때까지 MiniportInitialize에 대한 호출을 지연한다.

NdisMRegisterMiniport을 호출하는 드라이버들은 MiniportInitialize 함수들에 대한 바로(immediate) 호출을 위해 준비되어져야 한다. 그러한 드라이버는 레지스트리에 저장된, 혹은 어떤 NIC 특정 자원들을 설정하기 위해 NdisXxx 버스타입 특정 구성 함수에 대한 호출로부터 이용할 수 있는 충분한 설치와 구성 정보를 가져야 하고 드라이버가 네트워크 I/O 연산들을 실행하는데 필요하다. NdisIMRegisterLayeredMiniport를 호출하는 드라이버들은 NdisIMInitializeDeviceInstance에 대한 호출을 하는 또 하나의 드라이버 제공 함수에 대한 MiniportInitialize 함수들에 대한 호출을 지연한다. NDIS intermediate 드라이버들은 항상 ProtocolBindAdapter 함수을 등록하고 NdisIMRegisterLayeredMiniport 를 호출한다. 그래서 NDIS는 모든 아랫계층 NIC 드라이버들이 초기화된 후 ProtocolBindAdapter 함수를 호출할 것이다. 이러한 전략은 ProtocolBindAdapter 함수로부터 NdisIMInitialzieDeviceInstance에 대한 호출을 하는 NDIS intermediate 드라이버에게 다음과 같은 것을 제공한다. MiniportInitialize 함수가 가지는 장점은 intermediate 이 이미 바인드된 아랫 계층 NIC 드라이버의 특정에 대해 intermediate의 가상 NIC을 위한 드라이버 할당 자원들을 구성한다.

만약 NdisMRegisterMiniport 혹은 NdisIMRegisterLayeredMiniport가 NDIS_STATUS_SUCCESS를 리턴하지 않는다면은, DriverEntry는 NdisWrapperHandle를 유지하기 위한 메모리와 같은 할당된 어떤 자원들을 해제해야 하고 제어를 리턴하기 전에 NdisTerminateWrapper 함수를 호출해야 한다. 드라이버는 만약 이것이 발생한다면은 로드되지 않을 것이다.

디폴트로 DriverEntry는 시스템 쓰레드 컨텍스트에서 IRQL PASSIVE_LEVEL에서 실행한다.