ProtocolCoAfRegisterNotify

VOID ProtocolCoAfRegisterNotify( IN NDIS_HANDLE ProtocolBindingContext, IN PCO_ADDRESS_FAMILY AddressFamily );

모든 연결 지향 NDIS 클라이언트들은 완전하게 기능적인 ProtocolCoAfRegisterNotify 함수들을 가져야 한다. 혼자의 연결 지향 콜 매니저들은 단지 제어를 리턴하는 ProtocolCoAfRegisterNotify 함수들을 등록해야 한다.

매개변수

ProtocolBindingContext

클라이언트 프로토콜이 바인딩 당 런타임 상태를 유지하는 클라이언트 할당 컨텍스트 영역에 대한 핸들을 지정한다. 클라이언트의 ProtocolBindAdapter 함수는 이 핸들을 NdisOpenAdapter함수를 호출할 때 제공한다.

AddressFamily

NdisCmRegisterAddressFamily 혹은 NdisMCmRegisterAddressFamily 함수를 호출함으로써 NDIS에게 이러한 서비스들을 등록하는 콜 매니저에 의해 제공된 시그널링 프로토콜 제공을 설명하는 버퍼를 가리킨다.

주석

ProtocolCoAfRegisterNotify 함수에 대한 호출이 클라이언트가 바인드한 아래 연결 지향 NIC에 특정 호출 매니저의 혹은 MCM 드라이버의 콜 관리 서비스들을 광고한다.

ProtocolCoAfRegisterNotify 함수는 클라이언트가 일한 특정 콜 매니저의 서비스를 사용할 수 있는지를 결정하기 위해 AddressFamily에 데이터를 조사한다. 클라이언트가 AddressFamily에 (M)CM-제공 데이터를 수정할 수 있는지는 콜 매니저의 특정 시그널링 프로토콜 지원에 의존한다.

만약 클라이언트가 제공된 수락할 수 없는 콜 관리 서비스들을 발견한다면, ProtocolCoAfRegisterNotify 함수는 제어를 리턴하고 NDIS는 다시 같은 ProtocolBindingContext 핸들과 이것 혹은 같은 아래 NIC 드라이버에 바인드된 또 하나의 콜 매니저에 의해 제공된 AF 사양으로 다시 ProtocolCoAfRegisterNotify 함수를 호출할 것이다. 그렇지 않으면 ProtocolCoAfRegisterNotify 함수는 클라이언트를 위해 AF당 컨텍스트 영역을 할당하고 AddressFamily 포인터로 NdisClOpenAddressFamily 함수를 호출한다. 만약 이러한 호출이 성공한다면, 클라이언트는 이러한 콜 매니저의 서비스들을 사용하여 계속적인 연결 지향 연산들을 위해 NDIS에게 ProtocolClXxx 함수들을 등록한다.

예를 들어, ProtocolCoAfRegisterNotify 함수 혹은 ProtocolClOpenAfComplete 함수는 클라이언트가 계속해서 필요하는 SAP당, VC당, party당 컨텍스트 영역들의 동적 할당들과 해제들을 위한 준비로 한번 혹은 여러번 NdisInitializeNPagedLookasideList 함수를 호출할 것이다.

만약 들어오는 호출들을 허락한다면, 클라이언트의 ProtocolCoAfRegisterNotify 함수 혹은 ProtocolClOpenAfComplete 함수는 항상 콜 매니저에게 하나 혹은 그 이상의 SAP들을 등록한다. 그러한 콜 매니저의 AF를 연 후, 클라이언트는 SAP당 상태 영역을 할당할 것이고 NdisClOpenAddressFamily 함수로부터 얻은 NdisAfHandle로 한번 혹은 여러번 NdisClRegisterSap 함수를 호출할 것이다. 만약 나가는 호출들을 한다면, 클라이언트는 VC당 상태 영역을 할당하는 것을 처리할 것이고 리모트 노드에 대한 나가는 호출을 하는 자신의 클라이언트의 하나로부터 들어오는 요구의 기대로 NdisCoCreateVc 함수로 VC를 만들것이다.

디폴트로, ProtocolCoAfRegisterNotify 함수는 IRQL PASSIVE_LEVEL에서 실행한다.