ProtocolCmDeregisterSap
NDIS_STATUS
ProtocolCmDeregisterSap(
IN NDIS_HANDLE CallMgrSapContext
);
|
ProtocolCmDeregisterSap 함수는 연결 지향 클라이언트을 위해 콜 매니저가 SAP를 등록해제하는 것을 요구하기 위해 NDIS에 의해 호출되어지는 필요한 함수이다.
매개변수
- CallMgrSapContext
- 콜 매니저가 SAP당 상태 정보를 유지하는 콜 매니저 할당 컨텍스트 영역에 대한 핸들을 지정한다. 콜 매니저는 ProtocolCmRegisterSap 함수로부터 NDIS에게 이러한 핸들을 제공한다.
리턴값
ProtocolCmDeregisterSap 함수는 다음과 같은 하나로 연산들의 상태를 리턴한다.
- NDIS_STATUS_SUCCESS
- 콜 매니저가 성공적을 SAP 등록을 제거하는 것과 SAP당 정보를 유지하기 위해 할당된 어떤 자원들을 해제하는 것을 가리킨다.
- NDIS_STATUS_PENDING
- 콜 매니저는 비동기적으로 SAP를 등록 해제하기 위한 요구를 완성한다는 것을 가리킨다. 콜 매니저는 연산이 완성될 때 NDIS에게 신호화하기 위해 NdisCmDeregisterSapComplete 함수를 호출해야 한다.
주석
ProtocolCmDeregisterSap 함수는 네트워크에서 SAP를 등록해제하기 위해 필요하다면 다른 미디어 특정 에이전트들 혹은 네트워크 제어 장치들과 통신한다. 그러한 활동들은 다음을 포함할 수 있지만 제한적이지 않다.
- 스위칭 하드웨어와 통신한다.
- 네트워크 제어 스테이션과 통신한다.
- 다른 미디어 특정 네트워크 에이전트들과 통신한다.
만약 콜 매니저가 네트워크 스위치와 같은 네트워킹 제어 에이전트들과 통신하기 위해 필요하다면, ProtocolBindAdapter 함수에 설립된 네트워크 제어 에이전트와 가상 연결을 사용해야 한다. Standalone 콜 매니저들은 NdisCoSendPackets 함수를 호출함으로써 아래 NIC 미니포트를 통해 통신한다. 통합 콜 관리 지원을 제공하는 NIC 미니포트들은 NdisCoSendPackets 함수들을 결코 호출하지 않는다. 그 대신에, 그들은 직접 데이터를 네트워크에 전송한다.
추가적으로, ProtocolCmDeregisterSap 함수는 NDIS에 제어를 리턴하기 전에 상태 영역을 해제하는 것과 마찬가지로 CallMgrSapContext에 제공된 SAP 당 영역에 어떤 동적으로 할당된 자원들을 해제해야 한다.
ProtocolCmDeregisterSap 함수는 IRQL DISPATCH_LEVEL에서 실행할 수 있도록 쓰여져야 한다.
|