NdisCmRegisterAddressFamily

NDIS_STATUS NdisCmRegisterAddressFamily( IN NDIS_HANDLE NdisBindingHandle, IN PCO_ADDRESS_FAMILY AddressFamily, IN PNDIS_CALL_MANAGER_CHARACTERISTICS CmCharacteristics, IN UINT SizeOfCmCharacteristics );

NdisCmRegisterAddressFamily함수는 CM지정 어드레스 패밀리에 대한 연결지향 통신에대한 콜 매니저 지원 함수의 설정을 등록한다.

매개변수

NdisBindingHandle

타겟 닉혹은 호출자가 바인딩된 다음 하위 드라이버의 가상 아답터를 확인하는 NdisOpenAdapter함수에의해 리턴된 핸들을 지정한다.

AddressFamily

이 바인딩을 지원하는콜 매니저와 어드레스 패밀리를 확인하는 CO_ADDRESS_FAMILY타입 구조체의 포인터.

주어진 AddressFamily는 같은 연결지향 닉 미니포트에게 바인딩된 모든 클라이언트의 ProtocolCoAfRegisterNotify함수의 입력 파라미터가 된다.

CmCharacteristics

호출자에의해 설정되는 NDIS_CALL_MANAGER_CHARACTERISTICS구조체의 포인터. CmCharacteristics구조체는 다음과 같이 정의된다.:


typedef struct _NDIS_CALL_MANAGER_CHARACTERISTICS {

    UCHAR  MajorVersion;

    UCHAR  MinorVersion;

    USHORT  Filler;           // 시스템 사용을 위해 예약

    UINT    Reserved;         // 시스템 사용을 위해 예약

    CO_CREATE_VC_HANDLER  CmCreateVcHandler;

    CO_DELETE_VC_HANDLER  CmDeleteVcHandler;

    CM_OPEN_AF_HANDLER  CmOpenAfHandler;

    CM_CLOSE_AF_HANDLER  CmCloseAfHandler;

    CM_REG_SAP_HANDLER  CmRegisterSapHandler;

    CM_DEREG_SAP_HANDLER  CmDeregisterSapHandler;

    CM_MAKE_CALL_HANDLER  CmMakeCallHandler;

    CM_CLOSE_CALL_HANDLER  CmCloseCallHandler;

    CM_INCOMING_CALL_COMPLETE_HANDLER

                             CmIncomingCallCompleteHandler;

    CM_ADD_PARTY_HANDLER  CmAddPartyHandler;

    CM_DROP_PARTY_HANDLER  CmDropPartyHandler;

    CM_ACTIVATE_VC_COMPLETE_HANDLER  CmActivateVcCompleteHandler;

    CM_DEACTIVATE_VC_COMPLETE_HANDLER

                             CmDeactivateVcCompleteHandler; 

    CM_MODIFY_CALL_QOS_HANDLER  CmModifyCallQoSHandler;

    CO_REQUEST_HANDLER  CmRequestHandler;

    CO_REQUEST_COMPLETE_HANDLER  CmRequestCompleteHandler;

} NDIS_CALL_MANAGER_CHARACTERISTICS, *PNDIS_CALL_MANAGER_CHARACTERISTICS;

프로토콜은 이 구조체를 다음의 멤버들을 설정하기전에 0으로 초기화한다.:

MajorVersion: 콜 매니저가 사용하는 이구조체의 메이저 버전을 지정한다. 현재 값은 0x05이다.
MinorVersion: 콜 매니저가 사용하는 이구조체의 마이너 버전을 지정한다. 현재의 값은 0x00이다.
Filler 와 Reserved: 호출자는 이 멤버를 이 구조체가 0으로 초기화된후 무시한다.
CmCreateVcHandler: 호출자의 ProtocolCoCreateVc함수의 엔트리 포인터를 지정한다.
CmDeleteVcHandler: 호출자의 ProtocolCoDeleteVc함수의 엔트리 포인트를 지정한다.
CmOpenAfHandler: 호출자의 ProtocolCmOpenAf 함수의 엔트리 포인트를 지정한다.
CmCloseAfHandler: 호출자의 ProtocolCmCloseAf 함수의 엔트리 포인트를 지정한다.
CmRegisterSapHandler: 호출자의 ProtocolCoDeleteVc함수의 엔트리 포인트를 지정한다.
CmDeregisterSapHandler: 호출자의 ProtocolCmDeregisterSap 함수의 엔트리 포인트를 지정한다.
CmMakeCallHandler: 호출자의 ProtocolCmMakeCall 함수의 엔트리 포인트를 지정한다.
CmCloseCallHandler: 호출자의 ProtocolCmCloseCall 함수의 엔트리 포인트를 지정한다.
CmIncomingCallCompleteHandler: 호출자의 ProtocolCmIncomingCallComplete 함수의 엔트리 포인트를 지정한다.
CmAddPartyHandler: 호출자의 ProtocolCmAddParty 함수의 엔트리 포인트를 지정한다.
CmDropPartyHandler: 호출자의 ProtocolCmDropParty 함수의 엔트리 포인트를 지정한다.
CmActivateVcCompleteHandler: 호출자의 ProtocolCmActivateVcComplete 함수의 엔트리 포인트를 지정한다.
CmDeactivateVcCompleteHandler: 호출자의 ProtocolCmDeactivateVcComplete 함수의 엔트리 포인트를 지정한다.
CmModifyCallQoSHandler: 호출자의 ProtocolCmModifyCallQoS 함수의 엔트리 포인트를 지정한다.
CmRequestHandler: 호출자의 ProtocolCoRequest 함수의 엔트리 포인트를 지정한다.
CmRequestCompleteHandler: 호출자의 ProtocolCoRequestComplete 함수의 엔트리 포인트를 지정한다.

SizeOfCmCharacteristics

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

리턴값

NdisCmRegisterAddressFamily 함수는 다음중 어떤것을 리턴할수 있다.:

NDIS_STATUS_SUCCESS

프로토콜은 NDIS로 주어진 어드레스 패밀리에대해 콜 매니저로써 등록 할수 있다. 그래서 NDIS는 스스로 같은 닉 드라이버와 바인딩하는 모든 크라이언트의 ProtocolCoAfRegisterNotify함수를 호출 할것이다.

NDIS_STATUS_RESOURCES

요청된 연산은 NDIS가 충분한 메모리를 할당할수 없거나 콜 매니저 혹은 이 어드레스 패밀리를 트랙하기위해 사용하는 상태를 초기화할수 없기 때문에 실패한다.

NDIS_STATUS_FAILURE

NDIS는 이 호출을 실패한다. 다음 이유중 하나에대해서 가능하다.:

이 호출자는 연결지향 프로토콜로써 등록 되지 않았다.

호출자가 바인딩된 닉 드라이버가 연결지향 미니포트로 등록되지 않았다.

또다른 콜 매니저가 이미 이 어드레스 패밀리로 등록 됐다.

호출자는 CmCharacteristics에 뮤효하거나 충분치 않은 정보를 제공한다.

호출자의 바인딩이 닫히고 있다.

주석

스스로를 NdisRegisterProtocol함수로 NDIS프로토콜 드라이버로써 등록하는 독립적인 콜 매니저만이 NdisCmRegisterAddressFamily함수를 호출한다. 그런 드라이버는 스스로를 NDIS로 지정한 바인딩에 등록 하기위해 ProtocolBindAdapter함수로부터 NdisCmRegisterAddressFamily 함수를 호출한다.

독립적인 콜 매니저의 ProtocolBindAdapter함수는 NdisCmRegisterAddressFamily함수가 호출되기전에 처음 하위 닉 미니포트와 NdisOpenAdapter로 바인딩을 성립할것이다. NDIS가 ProtocolBindAdapter함수를 다른 BindContext핸들로 호출할때마다, 이 콜 매니저함수는 바인딩을 성립하고 지원하는 어드레스 패밀리를 등록한다. 다시 말하면, 독립ㅈ거인 콜 매니저는 결국 어드레스 패밀리를 등록하고 연결지향 클라이언트에게 콜매니지먼트 서비스를 지원하는 각 닉에대한 ProtocolCm/CoXxx함수를 재등록한다. 콜 매니저는 바인딩되어있는 모든 닉 드라이버들에대해 하나이상의 어드레스 패밀리를 지원할수 있다.그러나 이러한 경우, 콜 매니저는 바인딩에대한 각 어드레스 패밀리에대해 같은 엔트리 포인트를 등록해야만한다. 단지 하나의 콜 매지저만이 어떤 지정된 닉 드라이버와 바인딩된 클라이언트에대해 지정된 어드레스 패밀리 타입을 지원할수 있다.

결과적으로, 그런 프로토콜 드라이버는 스스로를 독립적인 콜 매니저로 등록하고 NdisCmRegisterAddressFamily함수를 호출할때 같은 미니포트와 바인딩된 모든 클라이언트에대한 특별한 시그널링 서비스를 알린다. ProtocolBindAdapter함수가 독립적인 콜 매니저로써의 등록을 성공적으로 리턴한후, NDIS는 같은 닉 미니포트와 바인딩된 모든 클라이언트들의 ProtocolCoRegisterAfNotify함수를 호출한다. 다음으로 이러한 클라이언트들은 NDIS로 하여금 콜매니저가 막 어드레스 패밀리에대해 등록했던 ProtocolCmOpenAf함수를 호출하도록 한다.

독립적인 콜 매니저는 들어오는 호출과 나가는 호출들을 지원하지 않더라도 NdisCmRegisterAddressFamily함수를 호출할때 드라이버지원 ProtocolCm/CoXxx함수에대한 NDIS_CALL_MANAGER_CHARACTERISTICS구조체내의 모든CmXxx멤버들을 설정해야만한다. 그런 콜 매니저가 지원하지않는 연결지향 기능의 한 부분에대해, 자리 소유자(placeholder)ProtocolCmXxx함수들은 간단히 NDIS_STATUS_NOT_SUPPORTED를 리턴한다.

독립적인 콜 매니저가 NdisCmRegisterAddressFamily함수를 성공적으로 호출한후, NDIS는 CM가 이전에 NdisRegisterProtocol함수에게 넘긴 NDIS_PROTOCOL_CHARACTERISTICS함수의 RequestHandler 와 RequestCompleteHandler멤버내에 지정한 어떤 엔트리 포인트를 무시한다.

독립적인 콜 매니저들과 대조적으로, 또한 MCM드라이버 혹은 MCM미니포트라 불리는 통합 콜 매니저먼트를 지원하는 연결지향 닉 미니포트는 NDIS로 ProtocolCmXxx함수와 ProtocolCoXxx함수들을 등록하기위해 NdisMCmRegisterAddressFamily함수를 호출할것이다. 그런 미니포트는 결코 NdisRegisterProtocol 혹은 NdisOpenAdapter함수를 호출하지 않을것이다.

NdisCmRegisterAddressFamily함수의 호출자는 일반적으로 IRQL PASSIVE_LEVEL에서 그리고 시스템 스레스 컨텍스트내에서 동작한다. NdisCmRegisterAddressFamily함수는 IRQL < DISPATCH_LEVEL에서 호출되어야만 한다.