ProtocolCmRegisterSap
NDIS_STATUS
ProtocolCmRegSap(
IN NDIS_HANDLE CallMgrAfContext,
IN PCO_SAP Sap,
IN NDIS_HANDLE NdisSapHandle,
OUT PNDIS_HANDLE CallMgrSapContext
);
|
ProtocolCmRegisterSap 함수는 콜 매니저가 연결 지향 클라이언트를 위해 SAP(Service Access Point)를 등록하는 것을 요구하기 위해 NDIS에 의해 호출되는 필요한 함수이다.
매개변수
- CallMgrAfContext
- 콜 매니저는 open당 AF 상태를 유지하는 데 콜 매니저 할당된 컨텍스트 영역에 대한 핸들을 지정한다. 콜 매니저는 이 핸들을 ProtocolCmOpenAf 함수로부터 NDIS에게 이 핸들을 제공한다.
- Sap
- 연결 지향 클라이언트가 등록하는 특정 SAP를 포함하는 미디어 특정 CO_SAP 구조체를 가리킨다.
- NdisSapHandle
- 유일하게 이러한 SAP을 지정하는 NDIS에 의해 제공된 핸들을 지정한다. 이 핸들은 콜 매니저에게 불분명하고 NDIS 라이브러리 사용을 위해 예약되었다.
- CallMgrSapContext
- 리턴하자마자, 콜 매니저가 이러한 SAP에 대한 상태를 유지하는 콜 매니저 제공 컨텍스트 영역에 대한 핸들을 지정한다.
리턴값
ProtocolCmRegisterSap 함수는 다음과 같은 하나로 연산들의 상태로 리턴한다.
- NDIS_STATUS_SUCCESS
- 콜 매니저는 성공적으로 SAP를 등록하고 유지하기 위해 어떤 필요한 자원들을 할당하고 초기화하는 것을 가리킨다. 추가적으로, 또한 SAP는 콜 매니저가 지원하는 네트워크 미디어에 의해 필요한 만큼 성공적으로 등록됐다는 것을 가리킨다.
- NDIS_STATUS_PENDING
- 콜 매니저는 비동기적으로 이러한 요구의 처리를 완성할 것을 가리킨다. 콜 매니저들은 모든 처리가 등록이 마쳤다는 것을 NDIS에게 시그널링하기 위해 완성될 떄 NdisCmRegisterSapComplete 함수를 호출해야 한다.
- NDIS_STATUS_RESOURCES
- Sap에 제공된 사양이 유효하지 않거나 제공될 수 없다는 것을 가리킨다.
- NDIS_STATUS_XXX
- 콜 매니저는 연결 지향 클라이언트를 위해 SAP을 등록하는 것을 시도하는 것이 에러를 만났다는 것을 가리킨다.리턴 코드는 에러에 맞춰지고 또하나의 NDIS 라이브러리 함수로부터 전달된 리턴 코드가 될 것이다.
주석
ProtocolCmMakeCall 함수는 연결 지향 클라이언트를 위한 네트워크에서 Sap를 지정한 것처럼 SAP를 등록하기 위해 필요하다면, 다른 미디어 특정 에이전트들 혹은 네트워크 제어 장치들과 통신한다. 그러한 행동들은 제한적이지 않지만 스위칭 하드웨어와 통신하는 것, 네트워크 제어 스테이션을 통신하는 것 혹은 네트워크 미디엄에 적당한 다른 행동들을 포함한다.
만약 콜 매니저가 네트워크 제어 에이전트들과(네트워크 스위치) 통신하기 위해 필요된다면, ProtocolBindAdapter 함수로 설립된 네트워크 제어 에이전트와 가상 연결을 사용해야 한다. 혼자인 콜 매니저들은 NdisCoSendPackets 함수를 호출함으로써 아래 NIC 미니포트를 통해 통신한다. 통합 콜 관리 지원을 하는 NIC 미니포트들은 결코 NdisCoSendPackets 함수를 호출하지 않는다. 그 대신에 그들은 네트워크로 직접 데이터를 전송한다. 추가적으로, ProtocolCmRegisterSap 함수는 콜 매니저가 연결 지향 클라이언트를 위해 SAP에 대한 상태 정보를 유지하는 데 필요한 동적 자원들과 구조체들의 어떤 필요한 할당들을 행해야 한다. 그러한 자원들은 다음과 같은 것들로 제한적이지 않지만 메모리 버퍼들, 데이터 구조체들, 이벤트들, 다른 그러한 유사한 자원들을 포함한다. 콜 매니저는또한 NDIS에게 제어를 리턴하기 전에 할당한 어떤 자원들을 초기화해야 한다. 콜 매니저들은 미래 사용을 위해 그들의 컨텍스트 영역에 NdisSapHandle로 제공된 SAP를 지정하는 NDIS 제공 핸들을 저장해야 한다.
만약 ProtocolCmRegisterSap 함수가 NDIS_STATUS_SUCCESS를 리턴한다면, SAP당 상태 영역을 할당한 후 NDIS에게 제어를 리턴하기 전에 CallMgrSapContext인 이러한 상태 영역내의 주소를 설정해야 한다. 이러한 하기 위해, CallMgrSapContext를 참조하는 것을 해제하고 핸들의 값으로서 데이터 영역에 대한 포인터를 저장한다. 예를 들어 :
*CallMgrSapContext = SomeBuffer;
만약 이미 또하나의 연결 지향 클라이언트에 의해 등록된 주어진 SAP이면 콜 매니저는 요구를 실패해야 하고 NDIS_STATUS_INVALID_DATA를 리턴해야 한다.
콜 매니저가 연결 지향 클라이언트을 위해 SAP을 등록한 후, 그러한 클라이언트에게 NdisCmDispatchIncomingCall 함수를 호출함으로써 그러한 SAP로 보내어지는 들어오는 호출 제의를 알린다.
ProtocolCmRegisterSap 함수는 IRQL DISPATCH_LEVEL에서 실행할 수 있도록 쓰여져야 한다.
|