NDIS 프로토콜 드라이버의 DriverEntry

NTSTATUS DriverEntry ( IN PDRIVER_OBJECT DriverObject, IN PUNICODE_STRING RegistryPath );

DriverEntry 함수는 시스템이 연결 지향 클라이언트들과 stand-alone 콜 매니저들을 포함한 NDIS 프로토콜 혹은 인터미디엇 드라이버에서 처음 호출하는 필요한 함수이다.

매개변수

DriverObject

이러한 드라이버를 표시하는 드라이버 객체를 가리킨다.

RegistryPath

드라이버의 설치 스크립트(.inf)에 의해 설정된 드라이버 특정 레지스트리 경로 사양을 가리킨다. 드라이버 설치 스크립트들에 대한 더 많은 정보에 대해서 Setup, Plug & Play, Power Management Design Guide and Reference를 봐라.

리턴값

DriverEntry는 만약 드라이버가 성공적으로 NDIS 프로토콜로 등록된다면, STATUS_SUCCESS 혹은 동등한 NDIS_STATUS_SUCCESS를 리턴한다. 만약 DriverEntry함수가 커널 모드 지원 루틴에 의해 혹은 NdisXxx 함수들에 의해 리턴된 에러 상태를 전달함으로써 초기화가 실패한다면, 드라이버는 로드되지 않고 남을 것이다. DriverEntry 함수는 동기적으로 실행해야 한다.; 즉 STATUS_PENDING 혹은 동등한 NDIS_STATUS_PENDING을 리턴할 수 없다.

주석

모든 타입의 NDIS 프로토콜 드라이버의 DriverEntry 함수는 NDIS 라이브러리로 드라이버의 ProtocolXxx 엔트리 포인트들을 등록하기 위해 NdisRegisterProtocol 함수를 호출해야 한다. 모든 타입들의 NDIS 프로토콜들은 plug and play를 지원하기 위해 완전한 기능의 ProtocolBindAdapter 함수와 ProtocolUnbindAdapter 함수들을 등록해야 한다. 일반적으로, DriverEntry 함수는 STATUS_SUCCESS 혹은 NDIS_STATUS_SUCCESS로 제어를 리턴하기 전에 단지 NdisRegisterProtocol 함수를 호출해야 한다.

NDIS 정의 ProtocolXxx 함수들에 추가적으로 표준 커널 모드 드라이버 루틴들의 집합들을 익스포트하는 어떤 프로토콜 드라이버는 DriverEntry 함수에 전달되는 주어진 드라이버 객체에 이러한 드라이버 루틴들을 위한 엔트리 포인트들을 설정해야 한다. 그러한 프로토콜 드라이버의 DriverEntry 함수의 기능에 대해 더 많은 정보는 Setup, Plug and Play, Power Management Design Guide와 마찬가지로 Kernel-Mode Driver Design Guide 를 봐라.TDI 전송 계층 프로토콜들에 의해 익스포트되는 TdiDispatchXxx 루틴들에 대한 더 많은 정보에 대해 Part 3을 봐라.

드라이버가 네트워크 I/O 연산들을 실행하기 위해 필요한 자원들을 할당하는 시도가 실패한다면, DriverEntry 함수는 이미 STATUS_SUCCESS 혹은 NDIS_STATUS_SUCCESS와 다른 상태로 제어를 리턴하기 전에 이미 할당한 모든 자원들을 해제해야 한다.

NdisRegisterProtocol 함수가 호출한 후, 연결 지향 클라이언트 프로토콜들은 연속적으로 NDIS에 그들의 ProtocolClXxx 함수들을 등록하기 위해 ProtocolCoAfRegisterNotify 함수들로부터 NdisClOpenAddressFamily 함수를 호출한다. 유사하게, 연결 지향 호출 관리자들과 MCM 드라이버들은 계속적으로 ProtocolBindAdapter 함수들로부터 NdisCmRegisterAddressFamily 함수를 호출하거나 혹은 그들의 ProtocolCmXxx 함수들을 등록하기 위해 각각 MiniportInitialize 함수들로부터 NdisMCmRegisterAddressFamily 함수를 호출한다.

아래 NIC 드라이버의 native 프레임 포맷을 상위 레벨 프로토콜을 위해 또 하나의 포맷으로 전환하는 하나와 같이 NDIS 인터미디엇 드라이버를 어떤 NdisXxx 함수들로 해석되지 않은 DriverEntry 함수에 대한 입력 매개변수들을 전달한다.

항상, 그러한 NDIS 인터미디엇 드라이버의 DriverEntry 함수는 다음과 같은 순서로 다음의 NdisXxx 함수들을 호출한다.

1. 드라이버는 미니포트로 막 등록하려고 하는 것에 대해 NDIS 라이브러리에 알리기 위해 NdisMInitializeWrapper 함수를 호출한다.
2. 드라이버의 MiniportXxx 함수들을 등록하기 위해 NdisIMRegisterLayeredMiniport 함수를 호출한다.
3. 드라이버의 ProtocolXxx 함수들을 등록하기 위해 NdisRegisterProtocol 함수를 호출한다.

   그러한 인터미디엇 드라이버는 NdisRegisterProtocol 함수를 호출할 때 NDIS 라이브러리로 ProtocolBindAdapter 함수와 ProtocolUnbindAdapter 함수들을 등록해야 한다. ProtocolBindAdapter 함수가 후에 드라이버 초기화를 완성하기 위해 그리고 아래 NIC 미니포트와 인터미디엇 드라이버를 바인드하기 위해 호출될 것이다.

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