NdisMRegisterMiniport

NDIS_STATUS 

  NdisMRegisterMiniport(

    IN NDIS_HANDLE  NdisWrapperHandle,

    IN PNDIS_MINIPORT_CHARACTERISTICS  MiniportCharacteristics,

    IN UINT  CharacteristicsLength

    );

NdisMRegisterMiniport는 NIC 드라이버 초기화 단계에서 첫번쨰 단계로서 NDIS 라이브러리에게 미니포트의 MiniportXxx 엔트리 포인트들을 등록한다.

매개변수

NdisWrapperHandle
NdisMInitializeWrapper에 의해 리턴된 핸들을 지정한다.

MiniportCharacteristics
호출자에 의해 설정된 NDIS_MINIPORT_CHARACTERISTICS 구조체를 가리킨다. MiniportCharacteristics에서 구조체는 다음과 같이 정의되어 있다. 

typedef struct _NDIS_MINIPORT_CHARACTERISTICS

{

   UCHAR MajorNdisVersion;

   UCHAR MinorNdisVersion;

   UINT Reserved;

   W_CHECK_FOR_HANG_HANDLER CheckForHangHandler;

   W_DISABLE_INTERRUPT_HANDLER DisableInterruptHandler;

   W_ENABLE_INTERRUPT_HANDLER EnableInterruptHandler;

   W_HALT_HANDLER HaltHandler;

   W_HANDLE_INTERRUPT_HANDLER HandleInterruptHandler;

   W_INITIALIZE_HANDLER InitializeHandler;

   W_ISR_HANDLER ISRHandler;

   W_QUERY_INFORMATION_HANDLER QueryInformationHandler;

   W_RECONFIGURATION_HANDLER ReconfigurationHandler;

   W_RESET_HANDLER ResetHandler;

   W_SEND_HANDLER SendHandler;

   W_SET_INFORMATION_HANDLER SetInformationHandler;

   W_TRANSFER_DATA_HANDLER TransferDataHandler;

//

// Version used is V4.0 or V5.0

// with following members

//

   W_RETURN_PACKET_HANDLER ReturnPacketHandler;

   W_SEND_PACKETS_HANDLER SendPacketsHandler;

   W_ALLOCATE_COMPLETE_HANDLER TransferDataHandler;

//

//    Version used is V5.0 with the following members

//

   W_CO_CREATE_VC_HANDLER CoCreateVcHandler;

   W_CO_DELETE_VC_HANDLER CoDeleteHandler;

   W_CO_ACTIVATE_VC_HANDLER CoActivateVcHandler;

   W_CO_DEACTIVATE_VC_HANDLER CoDeactivateVcHandler;

   W_CO_SEND_PACKETS_HANDLER CoSendPacketsHandler;

   W_CO_REQUEST_HANDLER CoRequestHandler;

} NDIS_MINIPORT_CHARACTERISTICS, *PNDIS_MINIPORT_CHARACTERISTICS;
드라이버는 다음과 같은 멤버들을 설정하기 전에 0으로 이 구조체를 초기화해야 한다.

MajorNdisVersion
드라이버가 사용하는 NDIS 라이브러리의 주 버전을 지정한다. 현재 값은 0x05이다. 비록 NDIS 라이비러리가 NDIS V4.0 그리고 V3.0을 위해 개발된 존재하는 NIC 드라이버들을 계속해서 지원한다.

이 멤버는 만약 호출자가 TransferDataHandler 다음의 멤버들의 엔트리 포인트 설정한다면은 0x05 혹은 0x04로 설정될 것이다. ; 만약 호출자가 AllocateCompleteHandler 다음의 멤버들의 엔트리 포인터들을 설정한다면은 0x05로 설정될 것이다.

MinorNdisVersion
드라이버가 사용하는 NDIS 라이브러리의 마이너 버전을 지정한다. 현재 값을 0x00이 된다.

Reserved
이 멤버는 시스템 사용을 위해 예약되었다.

CheckForHangHandler
호출자의 MiniportCheckForHang 함수의 엔트리 포인트를 지정하든지 NULL로 지정한다.

DisableInterruptHandler
호출자의 MiniportDisableInterrupt 함수의 엔트리 포인트를 지정한다. if any

EnableInterruptHandler
호출자의 MiniportEnableInterrupt 함수의 엔트리 포인트를 지정한다. if any

HaltHandler
호출자의 MiniportHalt 함수의 엔트리 포인트를 지정한다.

HandleInterruptHandler
호출자의 MiniportHandleInterrupt 함수의 엔트리 포인트를 지정한다. if any

InitializeHandler
호출자의 MiniportInitialize 함수의 엔트리 포인트를 지정한다.

ISRHandler
호출자의 MiniportISR 함수의 엔트리 포인트를 지정한다. if any. 이 미니포트 함수는 만약 나중에 드라이버가 MiniportInitialize함수로부터 NdisMRegisterInterrupt를 호출한다면은 필요로 한다.

QueryInformationHandler
호출자의 MiniportQueryInformation 함수의 엔트리 포인트를 지정한다. 만약 호출자가 MiniportCoRequest 함수를 지정한다면은 선택적이다.

ReconfigureHandler
호출자의 MiniportReconfigure 함수의 엔트리 포인트를 지정한다. 혹은 NULL이다.

ResetHandler
호출자의 MiniportReset 함수의 엔트리 포인트를 지정한다.

SendHandler
호출자의 MiniportSend 함수, MiniportWanSend 함수의 엔트리 포인트를 지정한다. 만약 호출자가 MiniportSendPackets 혹은 MiniportCoSendPackets 함수를 제공한다면은 NULL이다.

SetInformationHandler
호출자의 MiniportSetInformation 함수의 엔트리 포인트를 지정한다. 만약 호출자가 MiniportCoRequest 함수를 제공한다면은 선택적이다.

TransferDataHandler
호출자의 MiniportTransferData 함수의 엔트리 포인트를 지정한다. if any. 이 미니포트 함수는 만약 호출자가 WAN NIC의 드라이버이거나 호출자 multipacket 수신들을 지원하고 그러므로 ReturnPacketHandler에서 MiniportReturnPacket의 엔트리 포인트를 제공한다. 연결 지향 NIC들의 드라이버들은 멀티패킷 수신들을 제공해야 한다.

ReturnPacketHandler
호출자의 MiniportReturnPacket 함수의 엔트리 포인트를 지정한다. if any

SendPacketsHandler
호출자의 MiniportSendPackets 함수의 엔트리 포인트를 등록한다. if any. 만약 비연결 지향 NIC 드라이버가 또한 SendHandler 멤버의 엔트리 포인트를 설정한다면은 NDIS는 항상 MiniportSendPackets 함수를 호출한다. 연결 지향 NIC이 이 멤버 대신에 CoSendPacketsHandler 멤버를 설정해야 한다.

AllocateCompleteHandler
호출자의 MiniportAllocateComplete 함수의 엔트리 포인트를 지정한다. if any

CoCreateVcHandler
호출자의 MiniportCoCreateVc 함수의 엔트리 포인트를 지정한다. 만약 호출자가 통합 콜 매니저와 연결 지향 NIC(MCm) 드라이버면은, 이 멤버는 그러한 드라이버는 계속해서 NdisMCmRegisterAddressFamily로 콜 매니저로서 ProtocolCoCreateVc 함수를 등록하기 때문에 NULL로 설정된다.

CoDeleteVcHandler
호출자의 MiniportCoDeleteVc 함수의 엔트리 포인트를 지정한다. 만약 호출자가 통합 콜 매니저와 연결 지향(MCm) 드라이버면은 이 멤버는 그러한 드라이버가 계속해서 NdisMCmRegisterAddressFamily로 호출 관리자로서 ProtocolCoDeleteVc 함수를 등록하기 때문에 NULL로 설정한다.

CoActivateVcHandler
호출자의 MiniportCoActivateVc 함수의 엔트리 포인트를 지정한다.

CoDeactivateVcHandler
호출자의 MiniportCoDeactivateVc 함수의 엔트리 포인트를 지정한다.

CoSendPacketsHandler
호출자의 MiniportCoSendPackets 함수의 엔트리 포인트를 지정한다. SendHandler와 SendPacketsHandler 멤버들은 만약 드라이버가 MiniportCoSendPackets 함수를 지정한다면은 NULL이 될 것이다.

CoRequestHandler
호출자의 MiniportCoRequest 함수의 엔트리 포인트를 지정한다. 만약 드라이버가 또한 MiniportQueryInformation과 MiniportSetInformation 함수들을 제공한다면은 MiniportCoRequest 함수는 단지 OID_GEN_CO_XXX와 연결 지향 미디엄 특정 OID_XXX 요구들을 다룬다. 만약 드라이버가 QueryInformationHandler와 SetInformationHandler 멤버들을 NULL로 설정한다면은, MiniportCoRequest 함수는 모든 가능한 OID 요구들을 응답해야 한다. 모든 NDIS 미니포트들이 다뤄야 하는 OID_GEN_XXX를 포함한다.

CharacteristicsLength
호출자 제공 특정 버퍼의 바이트 크기를 지정한다. sizeof(NDIS_MINIPORT_CHARACTERISTICS). 할당된 정확한 버퍼 크기는 컴파일러 혹은 미니포트를 위한 설정된 빌드 디렉디브들에 의존한다.

예를 든다면, 다음 것은 만약 드라이버가 V5.0 NDIS_MINIPORT_CHARACTERISTICS 구조체를 사용한다면은 미니포트의 소스 코드의 시작에 붙여넣는 적당한 컴파일러 디렉티브(지시자)를 보여준다. 


#define NDIS_MINIPORT_DRIVER

#define NDIS50_MINIPORT 1

#include   // AFTER preceding directives
ndis.h의 포함은 NDIS_MINIPORT_DRIVER와 NDISXX_MINIPORT 디렉티브들 후 일어날 것이다. 여기서 XX는 50이 보여진 것과 같이 40이 될 수 있다. 만약 NDISXX_MINIPORT 디렉티브가 빠진다면은, NDIS_MINIPORT_CHARACTERISTICS 구조체 크기는 version 3.0 로 디폴트되어있다.

대체 방법으로 같은 드라이버는 선행 컴파일러 지시자를 사용하는 것 대신에 sources 파일내에 다음 build 지시자를 설정할 수 있다. 


....

C_FLAGS = $(C_FLAGS) -DNDIS_MINIPORT_DRIVER -DNDIS50_MINIPORT_DRIVER

....
대응하는 컴파일러 지시자와 같이 드라이버 개발자는 50과 마찬가지로 XX값이 40이 될 수 있는 -DNDISXX_MINIPORT_DRIVER 지시자를 지정할 수 있다.

적당한 컴파일러/빌드 지시자들을 설정하는 것이 자동적으로 CharacteristicsLength를 설정한다. characteristics 구조체의 MajorNdisVersion과 MinorVersion의 값 설정은 미니포트를 위해 컴파일러/빌드 지시자들로 일치해야 한다.

리턴값

NdisMRegisterMiniport는 만약 미니포트가 등록된다면은 NDIS_STATUS_SUCCESS가 리턴된다. 혹은 다음 상태 값들 중 하나가 리턴될 수 있다. :

NDIS_STATUS_BAD_CHARACTERISTICS
CharacteristicsLength는 MiniportCharacteristics에서 버퍼에 지정된 MajorNdisVersion보다 너무 작다.

NDIS_STATUS_BAD_VERSION
characteristics에 지정된 MajorNdisVersion 혹은 MinorNdisVersion이 잘못된 값이다.

NDIS_STATUS_RESOURCES
자원의 부족, 가능한한 메모리, 이 NDIS 라이브러리가 호출자를 등록하는 것을 막는다.

NDIS_STATUS_FAILURE
이것은 디폴트 에러 상태이다. 선행 에러들 아무것도 등록을 실패로 야기하지 않을 때 리턴된다.

주석

NIC 드라이버는 NdisMInitializeWrapper에 대한 호출 다음에 DriverEntry로부터 NdisMRegisterMiniport 를 호출한다.

모든 NIC 드라이버는 NdisMRegisterMiniport를 호출하고 특성 구조체를 설정함으로써 표준 MiniportXxx 함수들을 익스포트한다. 이 구조체는 NDIS 라이브러리 내부 저장 공간에 대한 NdisMRegisterMiniport 요구내에 복사되어진다. 일단 등록되어진다면은 미니포트 드라이버는 MiniportXxx 함수들을 바꿀 수 없다.

드라이버가 NdisMRegisterMiniport를 호출한 후 DriverEntry 함수가 제어를 리턴한 후, characteristics 구조체에 지정된 MiniportInitialize 엔트리 포인트에 콜백되어질 준비가 되어졌다. PnP 환경에서 NdisMRegisterMiniport에 대한 NIC 드라이버의 호출은 PnP 관리자가 NIC이 시작하기 위한 요구를 NDIS에게 보낼때까지 드라이버의 MiniportInitialize 함수를 호출하는 것을 지연하는 NDIS에 미니포트 엔트리 포인트들을 등록한다. PnP에 대한 더 자세한 내용은 Driver Setup, Plug and Play, Power Management를 봐라.

NDIS 라이브러리는 현재 MiniportReconfigure를 호출하지 않는다. 그래서 존재하는 미니포트 드라이버내에 함수는 미니포트가 MiniportInitialize로부터 MiniportReconfigure에 대한 내부 호출하기 전까지는 죽은 코드이다.

NDIS intermediate 드라이버들은, MiniportXxx와 ProtocolXxx 함수들을 익스포트하는, NdisMRegisterMiniport 를 호출하는 것 대신에 NdisIMRegisterLayeredMiniport를 호출해야 한다. 연결 지향 MCM 드라이버들은, 그러나, MiniportXxx 와 ProtocolCMXxx 함수들을 익스포트하는, MdisMRegisterMiniport를 호출한다.

NdisMRegisterMiniport에 대한 호출자는 IRQL PASSIVE_LEVEL에서 실행한다.