NdisIMRegisterLayeredMiniport

NDIS_STATUS NdisIMRegisterLayeredMiniport( IN NDIS_HANDLE NdisWrapperHandle, IN PNDIS_MINIPORT_CHARACTERISTICS MiniportCharacteristics, IN UINT CharacteristicsLength, OUT PNDIS_HANDLE DriverHandle );

NdisIMRegisterLayeredMiniport 함수는 드라이버가 초기화할 때 NDIS 라이브러리에게 인터미디엇 드라이버의 MiniportXxx 엔트리 포인트들과 이름을 등록한다.

매개변수

NdisWrapperHandle

NdisMInitializeWrapper 함수에 의해 리턴된 핸들을 리턴한다.

MiniportCharacteristics

호출자에 의해 설정된 NDIS_XX_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_RECONFIGURE_HANDLER ReconfigureHandler;

   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 AllocateCompleteHandler;

   //

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

   //

   W_CO_CREATE_VC_HANDLER CoCreateVcHandler;

   W_CO_DELETE_VC_HANDLER CoDeleteVcHandler;

   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;

NDIS 인터미디엇 드라이버는 다음과 같은 멤버들의 어떤 것을 설정하기 전에 0으로 이 구조체를 초기화해야 한다.

MajorNdisVersion

드라이버가 사용하는 NDIS 라이브러리의 메이저 버전을 지정한다. 현 값은 0x05이다. 비록 NDIS 라이브러리는 NDIS V4.0을 위해 개발된 존재하는 미니포트들을 계속해서 지원한다.

MininorNdisVersion

드라이버는 사용하는 NDIS 라이브러리의 마이너 버전을 지정한다. 현 값은 0x00이다. 비록 NDIS 라이브러리는 존재하는 드라이버들을 계속해서 지원한다.

Reserved

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

CheckForHangHandler

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

DisableInterruptHandler

NULL을 지정한다.

EnableInterruptHandler

NULL을 지정한다.

HaltHandler

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

HandleInterruptHandler

NULL을 지정한다.

InitializeHandler

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

ISRHandler

NULL을 지정한다.

QueryInformationHandler

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

ReconfigureHandler

NULL을 지정한다.

ResetHandler

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

SendHandler

호출자의 MiniportSend 함수, MiniportWanSend 함수의 엔트리 포인트를 지정한다. 호출자가 MIniportSendPackets 함수를 제공한다면은 NULL이다.

만약 드라이버가 멀티 패킷 보내기들 혹은 미디어 특정 정보를 제공한다면은, 그 대신에 SendPacketsHandler 멤버를 설정하고 이 멤버는 NULL을 설정한다.

SetInformationHandler

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

TransferDataHandler

있으면은 호출자의 MiniportTransferData 함수의 엔트리 포인트를 지정하거나 아니면은 NULL이다. 이러한 미니포트 함수는 만약 호출자가 WAN NIC의 드라이버가 아니거나 호출자가 멀티 패킷 수신들을 제공해서 ReturnPacketHandler에 MiniportReturnPacket 함수의 엔트리 포인트를 제공하지 않는다면은 필요된다.

ReturnPacketHandler

있으면은 호출자의 MiniportReturnPacket 함수의 엔트리 포인트를 지정하고 아니면은 NULL이다.

SendPacketsHandler

있으면은 호출자의 MiniportSendPackets 함수의 엔트리 포인트를 지정하고 아니면은 NULL이다.

AllocateCompleteHandler

NULL을 지정한다.

CoCreateVcHandler

NULL을 지정한다.

CoDeleteVcHandler

NULL을 지정한다.

CoActivateVcHandler

NULL을 지정한다.

CoDeactivateVcHandler

NULL을 지정한다.

CoSendPacketsHandler

NULL을 지정한다.

CoRequestHandler

NULL을 지정한다.

CharacteristicsLength

호출자 제공 특성 버퍼의 바이트 길이를 지정한다. MajorNdisVersion의 값에 의존하면서, 이 매개변수는 만약 드라이버가 NDIS50_MINIPORT_CHARACTERISTICS 구조체를 제공한다면은 sizeof(NDIS50_MINIPORT_CHARACTERISTICS)를 제공하거나 만약 드라이버가 NDIS40_MINIPORT_CHARACTERISTICS 구조체를 제공한다면은 sizeof(NDIS40_MINIPORT_CHARACTERISTICS)를 제공한다.

만약 드라이버가 sources 파일내에 빌드 명령어 NDIS50_MINIPORT (혹은 NDIS40_MINIPORT)를 포함하거나 드라이버 개발자가 -NDIS50_MINIPORT(혹은 ..40..) 컴파일러를 사용한다면은, 이 매개변수는 드라이버가 빌드될 때 설정된다.

DriverHandle

만약 호출이 성공적이라면은 NdisIMRegisterLayeredMiniport 함수는 호출자가 저장해야 하는 핸들을 리턴하는 변수를 가리킨다. 호출자는 계속해서 이 핸들을 ProtocolBindAdapter 함수로부터 항상 NdisIMInitializeDeviceInstance 함수에 대해 이 핸들을 전달해야 한다.

리턴값

NdisIMRegisterLayeredMiniport 함수는 만약 미니포트로서 호출가를 등록한다면은 NDIS_STATUS_SUCCESS 리턴하거나 다음과 같은 상태 값들 중에 하나를 리턴할 수 있다.

NDIS_STATUS_BAD_CHARACTERISTICS

CharacteristicsLength는 MiniportCharacteristics에 버퍼내에 지정된 MajorNdisVersion을 위해 너무 작다.

NDIS_STATIS_BAD_VERSION

characteristics 구조체내에 지정된 MajorNdisVersion 혹은 MinorNdisVersion은 유효하지 않다.

NDIS_STATUS_RESOURCES

가능한한 메모리와 같은 자원들은 부족은 NDIS 라이브러리가 미니포트로서 호출자를 등록하는 것을 막는다.

NDIS_STATUS_FAILURE

이 값은 선행 에러들의 아무것도 등록을 실패로 하지 않았을 때 디폴트 에러 상태이다. 예를 들어, 만약 NDIS 라이브러리가 드라이버의 이미지를 로드할 수 없고 시스템 메모리에 lock될 수 없다면은, 이 에러를 리턴한다.

주석

MiniportXxx 함수들과 ProtocolXxx 함수들을 익스포트하는 어떤 NDIS 인터미디엇 드라이버는 특성 구조체를 설정하고 DriverEntry 함수가 NdisMInitializeWrapper 함수를 호출한 후 DriverEntry 함수로부터 NdisIMRegisterLayeredMiniport 함수를 호출한다. 이 구조체는 NDIS 라이브러리의 내부 저장 공간에 NdisIMRegisterLayeredMiniport 함수 요구에 복사되어진다. 그러므로, 일단 등록된다면은, 그러한 드라이버는 핸들러 함수들을 변화할 수 없다.

그러한 NDIS 인터미디엇 드라이버가 성공적으로 NdisIMRegisterLayeredMiniport 함수를 호출한다면은, NDIS 라이브러리로 ProtocolXxx 함수들을 등록하기 위해 NdisRegisterProtocol 함수를 호출해야 한다. 그러한 드라이버는 항상 ProtocolBindAdapter 함수와 ProtocolUnbindAdapter 함수들을 가진다. ProtocolBindAdapter 함수는 아래 NIC 드라이버가 성공적으로 초기화되어질 때, 다음 호출되어질 것이다. ProtocolBindAdapter 함수는 그리고나서 NdisOpenAdapter 함수로 그러한 NIC 드라이버에 대한 바인딩을 만들 수 있다.

NDIS 인터미디엇 드라이버는 만약 아래 NIC 드라이버가 멀티 패킷 보내기들을 지원해야 하거나 혹은 상위 레벨 프로토콜에서 패킷 배열로 보내어질 때 패킷 우선권과 같은 미디어 특정 정보를 소비한다면은(consume) MiniportSendPackets 함수를 가져야 한다. NDIS 인터미디엇 드라이버는 만약 아래 NIC 드라이버가 멀티 패킷 수신 인디케이션 지원한다거나 혹은 미디어 특정 정보를 포함하는 패킷 배열들을 인디케이트한다면은 MiniportReturnPacket 함수를 가져야 한다. NDIS 라이브러리는 아래 NIC 드라이버와 인터미디엇 드라이버를 위해 하나의 패킷 전송들을 지원하는 상위 레벨 프로토콜 사이에 전송된 패킷 배열들을 다룬다.

NdisIMRegisterLayeredMiniport 함수의 호출자들은 IRQL PASSIVE_LEVEL에서 실행한다.