NdisClRegisterSap

NDIS_STATUS NdisClRegisterSap( IN NDIS_HANDLE NdisAfHandle, IN NDIS_HANDLE ProtocolSapContext, IN PCO_SAP Sap, OUT PNDIS_HANDLE NdisSapHandle );

NdisClRegisterSap함수는 클라이언트가 리모트 노드로부터 들어오는 호출들을 받을수 있는것에서 SAP를 등록한다.

매개변수

NdisAfHandle

NdisClOpenAddressFamily에의해 리턴된 핸들을 지정한다. 이것은 SAP를 등록하기위해 콜 매니저를 절대적으로 확인한다.

ProtocolSapContext

클라이언트가 이 열려진SAP에대한 상태를 유지하는것에대한 호출자 제공 상주 컨택스트 영역에대한 핸들을 지정한다. 만약 NdisClRegisterSap에대한 호출이 성공한다면 NDIS는 이핸들을 다시 이 SAP에 관한 순차적인 호출들내의 클라이언트에게 넘긴다.

Sap

CO_SAP타입 구조체로써 형성된 열려진 SAP에대한 호출자 제공 특성에대한 포인터.

NdisSapHandle

이 호출이 성공한다면 새롭게 등록된 SAP에대한 핸들이 리턴된 것에대한 변수의 포인터.

리턴값

NdisClRegisterSap함수는 NDIS_STATUS_PENDING이외의 다른 것을 리턴할때, 클라이언트는 ProtocolClRegisterSapComplete함수에대한 내부적인 호출을 만들어야만한다. 그렇지 안으면, NDIS는 이 연산이 완료됐을때, 클라이언트의ProtocolClRegisterSapComplete함수를 호출한다.

주석

NdisClRegisterSap의 호출로, 클라이언트는 특별한 SAP에대한 들어오는 호출의 알림을 요청한다. NDIS는 주어진 SAP정보를 콜 메니저의 ProtocolCmRegisterSap함수를 호출한다. 만약 주어진 SAP가 이미 사용 중이거나 콜 메니저가 SAP에서 클라이언트 제공 특성을 인식하지 않는다면, 콜 매니저는 이 요청을 실패한다.

SAP포맷은 미디엄-의존이고 콜 매니저에의해 지원되는 어드레스 패밀리를 지정한다. 이것은 SAP들을 순차적으로 적절한 클라이언트에게 들어오는 호출에게 등록한다. 콜 매니저는 다른 네트웍 컴포넌트들과의 마주침없이, 하위 미디엄에 의존하는것없이 성립된 PVC들에대한 SAP들을 등록할수 있다. 예를들어 만약 NdisClRegisterSap에게 주어진 SAP특성이 하나 혹은 ATM 콜 매니저에의해 이미 설정된 그이상의 PVC를 매치한다면, 클라이언트는 이러한 PVC들에대한 들어오는 호출을 즉시 받을수 있다. 심지어 SAP등록이 여전히 팬딩일동안에조차.

만약 NdisClRegisterSap함수의 호출이 성공이라면, 클라이언트는 NdisSapHandle에 리턴된 핸들을 지정해야만한다. 왜냐하면 NdisClDeregisterSap에대한 요구된 파라미터이기 때문이다. NdisClRegisterSap의 호출자는 일반적으로 포인터를 ProtocolSapContext에 클라이언트 할당 상태 영역내의 변수에 넘겨서 만약 이 호출이 성공한다면 NDIS가 그것을 NdisSapHandle에게 설정할수 있다. 클라이언트가 NdisClDeregisterSap함수를 호출할때까지, NDIS는 주어진 ProtocolSapContext를 이 SAP에 관한 모든 순차적인 호출들내에 클라이언트의 등록된 ProtocolCl/CoXxx함수에게 넘긴다.

일반적으로, 클라이언트는 NdisClOpenAddressFamily함수의 성공적인 호출을 따르는 ProtocolAfRegisterNotify함수로 부터 NdisClRegisterSap함수를 호출한다. 하나혹은 그이상의 SAP들을 등록하는것은 클라이언트가 콜 매니저가 네트웍상으로 들어오는 호출을 받자마자 들어오는 호출을 받도록 한다.

클라이언트가 초기화한 나가는 호출과는 대조적으로, 클라이언트는 NdisClRegisterSap을 호출하기전에, NdisCoCreateVc함수를 호출하지 않는다. 들어오는 호출에대해, 콜 매니저는 VC의 생성을 초기화한다. 다음과 같이:

• 등록된 SAP에대한 들어오는 호출의 수신에대해, 콜 매니저는 우선 NDIS로 하여금 클라이언트의 ProtocolCoCreateVc함수를 호출하도록 하는 NdisCoCreateVc함수를 호출한다.
• VC가 설정되고 활성화 될때, 콜 메니저는 NDIS로 하여금 클라이언트의 ProtocolClIncomingCall함수를 호출하도록 하는 NdisCmDispatchIncomingCall함수를 호출한다.