NdisMCmRegisterAddressFamily

NDIS_STATUS NdisMCmRegisterAddressFamily( IN NDIS_HANDLE MiniportAdapterHandle, IN PCO_ADDRESS_FAMILY AddressFamily, IN PNDIS_CALL_MANAGER_CHARACTERISTICS CmCharacteristics, IN UINT SizeOfCmCharacteristics );

NdisMCmRegisterAddressFamily함수는 MCM드라이버 지정 어드레스 페밀리로의 연결지향 통신에대한 콜매니저 함수의 설정을 등록한다.

매개변수

MiniportAdapterHandle

미니포트의 닉을 확인하는 NDIS제공 핸들을 지정한다. 이 핸들은 닉 드라이버의 MiniportInitialize함수에대한 입력 파라미터이다. 이것은 NdisMCmRegisterAddressFamily함수를 호출한다.

AddressFamily

MCM드라이버가 제공하는 어드레스 패밀리를 확인하는 CO_ADDRESS_FAMILY의 구조체의 포인터.

주어진 AddressFamily는 이 MCM드라이버에게 바인딩된 모든 클라이언트의 ProtocolCoAfRegisterNotify함수에대한 입력 파라미터가 된다.

CmCharacteristics

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

typedef struct _NDIS_CALL_MANAGER_CHARACTERISTICS {

    UCHAR  MajorVersion;

    UCHAR  MinorVersion;

    USHORT  Filler;           // reserved for system use

    UINT    Reserved;         // reserved for system use

    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;

MCM드라이버는 이 구조체를 다음과 같은 멤버로 설정하기전에 0으로 초기화 해야한다.

MajorVersion

이 구조체의 메이져 버전을 지정한다. 현재 버전은 0x05이다.

MinorVersion

이 구조체의 마이너 버전을 지정한다. 현재 버전은 0x00이다.

Filler 와 Reserved

호출자는 이 구조체를 0으로 초기화한후 이 멤버를 무시해야만 한다.

CmCreateVcHandler

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

CmDeleteVcHandler

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

CmOpenAfHandler

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

CmCloseAfHandler

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

CmRegisterSapHandler

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

CmDeregisterSapHandler

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

CmMakeCallHandler

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

CmCloseCallHandler

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

CmIncomingCallCompleteHandler

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

CmAddPartyHandler

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

CmDropPartyHandler

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

CmActivateVcCompleteHandler

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

CmDeactivateVcCompleteHandler

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

CmModifyCallQoSHandler

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

CmRequestHandler

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

CmRequestCompleteHandler

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

SizeOfCmCharacteristics

CmCharacteristics에 구조체의 바이트내의 사이즈를 지정한다.

리턴값

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

NDIS_STATUS_SUCCESS

미니포트는 NDIS로 주어진 어드레스 패밀로에대해 콜 매니저로써 등록되었다. 그래서 NDIS는 이 MCM 닉 드라이버엑 스스로 바인딩하는 모든 클라이언트의 ProtocolCoAfRegisterNotify함수를 호출할 것이다.

NDIS_STATUS_RESOURCES

요청된 연산은 실패했다. 왜냐하면, NDIS가 충분한 메모리를 할당 할 수 없거나 이 어드레스 패밀리의 콜 매니저로서 MCM드라이버를 트랙하기위해 사용하는 상태를 초기하기때문이다.

NDIS_STATUS_FAILURE

NDIS는 이 호출을 실패한다. 다음 이유중 하나일 가능성이 있다.:

• 호출자는 연결지향 미니포트로써 등록 되지 않았다.
• CmCharacteristics에 호출자 제공의 무효하거나 불충분한 정보.

주석

시스템내의 미디엄 타입 지정 독립적인 콜 매니저가 아닌 연결지향 닉 을 다루는 드라이버들 또한 NdisMRegisterMiniport함수의 호출후 NdisMCmRegisterAddressFamily함수를 호출한다. 재장형 연결지향 시그널링 지원을 가지고 있는 닉 드라이버는 스스로를 호출을 다루는데 있어 더 좋은 퍼포먼스에대한 MCM드라이버로 등롤할 수 있다. MCM드라이버로써 등록 하는것은 어떤 독립적인 콜 매니저를 닉 드라이버 소유의 콜 매니지먼트 지원으로 대신한다.

예를들어, 시스템이 모든 ATM닉 드라이버들에대해 독립적인 콜 매니저를 제공하기때문에, 자신의 미디엄을 NdisMediumAtm으로써 알리는 닉 드라이버는 NdisMCmRegisterAddressFamily함수를 호출할것 같지 않다. 그러나, 그런 ATM닉 드라이버는 만약 자신의 아답터가 내장형 연결지향 시그널링 지원을 가지고 있다면, NdisMCmRegisterAddressFamily함수를 호출 할지 모른다.

MCM닉 드라이버는 자신의 닉이 완전히 사용가능하여 드라이버가 네트웍 I/O연산을 수행할수 있은후에 스스로를 NDIS에게 콜 매니저로써 등록하기위해 MiniportInitialize함수로부터 NdisMCmRegisterAddressFamily함수를 호출한다. 결과적으로, 그런 MCM드라이버는 스스로를 콜 매니저로써 등록하고 MiniportInitialize함수가 NdisMCmRegisterAddressFamily함수를 호출할때, 순차적으로 같은 낙에게 스스로 바인딩된 모든 클라이언트에대한 자신의 특정한 시그널링 서비스를 알린다.

MiniportInitialize함수가 콜 매니저로써 성공적인 등록으로 컨추럴을 리턴한후, NDIS는 잠재적인 클라이언트의 ProtocolBindAdapter함수를 호출하여, 클라이언트 스스로를 MCM드라이버의 닉에게 바인딩하는 모든 클라이언트들의 ProtocolCoRegisterAfNotify함수를 호출한다. 이러한 클라이언트들은 교대로 NDIS로하여금 MCM닉 드라이버가 자신들의 어드레스 패밀리에대해 막 등록한 ProtocolCmOpenAf함수를 호출하도록 한다.

MCM드라이버는 NdisMCmRegisterAddressFamily함수를 호출할때, 심지어 들어어는 호출과 나가는 호출 혹은 포인트-멀티포인트 연결을 지원하지 않더라도, NDIS_CALL_MANAGER_CHARACTERISTICS구조체내의 모든 CmXxx멤버를 호출자 제공 ProtocolCm/CoXxx함수로 설정해야만 한다. MCM드라이버가 지원하지 않는 연결지향 기능중 하나가 지원하지것이 있을때마다, ProtocolCmXxx함수는 간단히 NDIS_STATUS_NOT_SUPPORTED함수를 리턴한다. 예를들어, NDIS는 결코 MCM드라이버의 등록된 ProtocolCmActivate/DeactivateVcComplete함수를 호출하지 않는다. 그래서 이러한 것은 NDIS_STATUS_NOT_SUPPORTED를 즉시 리턴할수 있지만 characteristics구조체내에 자리를 잡고 있다.

MCM드라이버는 ProtocolCoCreateVc 와ProtocolCoDeleteVc함수를 가져야만 하고 그들의 엔트리 포인트를 NdisMCmRegisterAddressFamily함수에게 넘겨지는 NDIS_CALL_MANAGER_CHARACTERISTICS구조체내에 설정해야만 한다. 만약 드라이버가 NdisMRegisterMiniport함수를 호출할때, 이전에 iniportCoCreate/DeleteVc함수를 등록했다면, NDIS는 MCM드라이버의 NdisMCmRegisterAddressFamily함수호출 후, 이런한 엔트리를 무시한다. NDIS가 VC를 만들고 지우기위해 MCM드라이버를 호출할때마다, NDIS는 독립적인 미니포트의 MiniportCoCreate/DeleteVc함수에게 넘기는 MiniportAdapterContext핸들보다는 미니포트제공 ProtocolCoCreate/DeleteVc함수에게 처음 파라미터로써 NdisAfHandle을 넘긴다.

MCM드라이버는 CmRequestHandler멤버를 MiniportCoRequest함수에게 설정할 수 없지만, NdisMCmRegisterAddressFamily함수를 호출할때, 분리된 ProtocolCoRequest함수를 제공한다. 심지어 그런 드라이버가 NdisMRegisterMiniport함수를 호출할때 이미 MiniportCoRequest, MiniportQueryInformation, 와 MiniportSetInformation함수에대한 엔트리 포인트를 제공했더라도,MCM드라이버는 클라이언트로부터 CM지정 요청들을 다루기위해 ProtocolCoRequest함수를 분리한다. MCM드라이버에대해, NDIS는 다음의 정책에따라 드라이버 제공 요청 핸들러의 설정을 호출한다.:

• 바인딩된 드라이버가 NdisRequest함수를 호출할때, 만약 닉 드라이버가 이러한 함수들을 NdisMRegisterMiniport함수로 등록한다면, 주어진 RequestType값에의존하여, NDIS는 닉 드라이버의 MiniportQueryInformation 혹은 MiniportSetInformation함수를 호출한다. 그렇지않으면, NDIS는 닉 드라이버의 등록된 MiniportCoRequest함수를 호출한다.
• 바인딩된 프로토콜 드라이버가 NULL NdisAfHandle로 NdisCoRequest함수를 호출할때, NDIS는 닉 드라이버의 등록된 MiniportCoRequest함수를 호출한다. 그렇지 않으면, NDIS는 MCM미니포트가 NdisMCmRegisterAddressFamily함수를 호출할때 CmRequestHandler멤버내에 설정된 드라이버 제공 ProtocolCoRequest함수를 호출한다.

MCM드라이버는 바인딩된 하나의 닉에대해 하나 이상의 어드레스 패밀리를 지원 할 수 있다. MCM드라이버는 바인딩에 대해 등록한 각 어드레스 패밀리에대해 한번 NdisCmRegisterAddressFamily함수를 호출해야만 하고 바인딩에대해 각 어드레스 패밀리에대한 같은 엔트리포인트를 등록해야만 한다. 단지 MCM드라이버만이 어떤 특정한 닉에 바인딩된 클라이언트에대한 특정 타입의 어드레스 패밀리를 지원할수 있다.

일반적으로 여러 닉 드라이버들에의존하는 클라이언트 들에게 콜 매니지먼트 지원을 제공하는 MCM드라어버들과 대조적으로, 독립적인 콜 매니저는 NDIS에게 ProtocolCmXxx 과 ProtocolCoXxx함수들로 등록하기위해 NdisCmRegisterAddressFamily함수를 호출한다.

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