NdisRegisterProtocol
VOID
NdisRegisterProtocol(
OUT PNDIS_STATUS Status,
OUT PNDIS_HANDLE NdisProtocolHandle,
IN PNDIS_PROTOCOL_CHARACTERISTICS ProtocolCharacteristics,
IN UINT CharacteristicsLength
);
|
NdisRegisterProtocol은 NDIS 드라이버의 ProtocolXxx 엔트리 포인트들과 드라이버를 초기화할 때 NDIS 라이브러리에 이름을 등록한다.
매개변수
- Status
- 이 함수가 리턴할 때 다음과 같은 값 중 하나가 될 수 있는 호출자 제공 변수를 가리킨다.
- NDIS_STATUS_SUCCESS
- NDIS 라이브러리는 프로토콜 드라이버로서 호출자를 등록한다.
- NDIS_STATUS_BAD_CHARACTERISTICS
- CharacteristicsLength가 ProtocolCharacteristics 버퍼내에 지정된 MajorNdisVersion를 위해 너무 작다.
- NDIS_STATUS_BAD_VERSION
- ProtocolCharacteristics 버퍼내에 지정된 MajorNdisVersion이 유효하지 않다.
- NDIS_STATUS_RESOURCES
- 가능한 메모리인 자원의 부족이 NDIS 라이브러리가 호출자를 등록하는 것을 방해한다.
- NdisProtocolHandle
- 이 함수가 등록된 드라이버를 표시하는 핸들을 리턴하는 호출자 제공 변수를 가리킨다.
- ProtocolCharacteristics
- 호출자에 의해 설정된 NDIS_PROTOCOL_CHARACTERISTICS 구조체를 가리킨다. ProtocolCharacteristics의 구조체는 다음과 같이 정의되어 있다.
typedef struct _NDIS_PROTOCOL_CHARACTERISTICS
{
UCHAR MajorNdisVersion;
UCHAR MinorNdisVersion;
UINT Reserved;
OPEN_ADAPTER_COMPLETE_HANDLER OpenAdapterCompleteHandler;
CLOSE_ADAPTER_COMPLETE_HANDLER CloseAdapterCompleteHandler;
SEND_COMPLETE_HANDLER SendCompleteHandler;
TRANSFER_DATA_COMPLETE_HANDLER TransferDataCompleteHandler;
RESET_COMPLETE_HANDLER ResetCompleteHandler;
REQUEST_COMPLETE_HANDLER RequestCompleteHandler;
RECEIVE_HANDLER ReceiveHandler;
RECEIVE_COMPLETE_HANDLER ReceiveCompletehandler;
STATUS_HANDLER StatusHandler;
STATUS_COMPLETE_HANDLER StatusCompleteHandler;
NDIS_STRING Name;
//
// MajorNdisVersion must be set to 0x04
// with any of the following members
//
RECEIVE_PACKET_HANDLER ReceivePacketHandler;
BIND_HANDLER BindAdapterHandler;
UNBIND_HANDLER UnbindAdapterHandler;
TRANSLATE_HANDLER TranslateHandler;
UNLOAD_PROTOCOL_HANDLER UnloadHandler;
} NDIS_PROTOCOL_CHARACTERISTICS, *PNDIS_PROTOCOL_CHARACTERISTICS;
드라이버는 다음과 같은 멤버를 설정하기 전에 이 구조체를 0으로 초기화해야 한다.
- MajorNdisVersion
- 드라이버가 사용하는 NDIS 라이브러리의 메이저 버전을 지정한다. 비록 NDIS 라이브러리가 NDIS V3.0을 위해 개발된 존재하는 드라이버들을 계속해서 지원하지만은, 현재 값은 0x04이다. 이 멤버는 호출자는 호출자가 NDIS 인터미디엇 드라이버나 호출자가 Name 다음에 어떤 멤버들 내에 엔트리 포인트를 설정한다면은 0x04로 설정되어져야 한다.
- MinorNdisVersion
- minor NDIS 버전을 지정한다. 비록 NDIS가 계속해서 존재하는 드라이버들을 지원하지 만은 현재 값은 0x00이다.
- Reserved
- 이 값은 시스템 사용으로 예약되었다.
- OpenAdapterCompleteAdapter
- 호출자의 ProtocolOpenAdapterComplete 함수의 엔트리 포인트를 지정한다.
- CloseAdapterCompleteHandler
- 호출자의 ProtocolCloseAdapterComplete 함수의 엔트리 포인트를 지정한다.
- SendCompleteHandler
- 호출자의 ProtocolSendComplete 함수의 엔트리 포인트를 지정한다.
- TransferDataCompleteHandler
- 호출자의 ProtocolTransferDataComplete 함수의 엔트리 포인트를 지정한다.
- ResetCompleteHandler
- 호출자의 ProtocolResetComplete 함수의 엔트리 포인트를 지정한다.
- RequestCompleteHandler
- 호출자의 ProtocolRequestComplete 함수의 엔트리 포인트를 지정한다.
- ReceiveHandler
- 호출자의 ProtocolReceive 함수의 엔트리 포인터를 지정한다.
- ReceiveCompleteHandler
- 호출자의 ProtocolReceiveComplete 함수의 엔트리 포인트를 지정한다.
- StatusHandler
- 호출자의 ProtocolStatus 함수의 엔트리 포인트를 지정한다.
- StatusCompleteHandler
- 호출자의 ProtocolStatusComplete 함수의 엔트리 포인트를 지정한다.
- Name
- 드라이버를 이름지우는 시스템 디폴트 문자 세트로 버퍼화된 호출자 초기화 카운트화된 문자열의 포인트를 지정한다. 윈도우즈 NT 드라이버에 대하여, 이 문자열은 유니코드 문자들을 포함한다.
NdisRegisterProtocol은 제공된 문자열을 대문자로 고치고, 그리고 나서 프로토콜 드라이버 작성자는 이미 등록된 프로토콜 이름의 케이스를 변하는 것이 드라이버를 위해 유일한 이름을 만드는 것을 추측할 수 없다.
- ReceivePacketHandler
- 호출자의 ProtocolReceivePacket 함수의 엔트리 포인트를 지정한다. 어떤 값이든 NULL 값이다. 멀티 패킷 인디케이션들을 지원하는 어떤 드라이버와 바인드한 프로토콜들은 그들의 퍼포먼스를 향상시키기 위해 ProtocolReceivePacket 함수를 제공해야 한다.
- BindAdapterHandler
- 호출자의 ProtocolBindAdapter 함수의 엔트리 포인트를 지정한다. 어떤 값이든 NULL이다. NDIS 인터미디엇 드라이버들은 항상 ProtocolBindAdapter 함수를 제공하고, 양쪽은 그들이 PnP-ready로 만들고 인터미디엇이 NdisIMRegisterLayeredMiniport를 호출하도록 허락하고 아래 계층 NIC 드라이버들이 초기화되었을 때까지 풀 드라이버 초기화를 지연시키게 한다.
- UnbindAdapterHandler
- 호출자의 ProtocolUnbindAdapter 함수의 엔트리 포인트를 지정한다. 어떤 값이든지 NULL이다. ProtocolBindAdapter 함수를 제공하면은 NDIS 드라이버들을 또한 ProtocolUnbindAdapter 함수를 제공해야 한다.
- TranslateHandler
- 호출자의 ProtocolTranslate함수의 엔트리 포인트를 지정한다. 만약 어떤 값이든 NULL이다. 그러한 함수는 현재 호출되지 않고 이 멤버는 PnP-aware(인식) 프로토콜들에 의해 미래 사용을 위해 예약되었다.
- UnloadHandler
- 윈도우즈 NT 프로토콜 드라이버들을 위해 NULL로 설정된다.
- CharacteristicsLength
- ProtocolCharacteristics에서 구조체의 바이트 크기를 지정한다. 만약 빌드 디렉티브(지시자)가 NDIS40이 #include ndis.h 앞에 소스파일들에 지정된다면은 이 값은 자동적으로 제공된다.
주석
CharacteristicsLength에 제공된 값은 이 구조체에서 제공된 MajorNdisVersion에 의해 지정된 적어도 sizeof(NDISXX_PROTOCOL_CHARACTERISTICS)가 될것이다.
최대의 가능한 퍼포먼스를 위하여, 멀티 패킷 리스브들을 제공하는 NIC 드라이버 위에 위치하는 어떤 프로토콜은 ProtocolReceivePacket 함수를 제공해야 한다. 멀티 패킷 보내기들을 제공하는 어떤 NIC 드라이버는 멀티 패킷 리스브들을 인디케이트하기 또한 쉽다.
ProtocolReceivePacket 함수를 제공하는 드라이버는 ProtocolReceive 함수를 또한 제공해야 한다. NdisRegisterProtocol에 대한 성공적인 호출후, 드라이버는 제공된 ProtocolXxx 함수들의 설정을 바꿀 수 없다.
성공적으로 등록된 드라이버는 NdisProtocolHandle에 리턴된 핸들을 저장해야 한다. 그것은 드라이버가 계속해서 호출하는 다른 NdisXxx 함수들에 대한 매개변수에 필요하다.
NdisRegisterProtocol의 호출자는 IRQL PASSIVE_LEVEL 실행한다.
|