ProtocolCmCloseCall
NDIS_STATUS
ProtocolCmCloseCall(
IN NDIS_HANDLE CallMgrVcContext,
IN NDIS_HANDLE CallMgrPartyContext OPTIONAL,
IN PVOID CloseData OPTIONAL,
IN UINT Size OPTIONAL
);
|
ProtocolCmMakeCall 함수는 콜 매니저가 호출을 위해 할당한 어떤 자원들을 해제하고 존재하는 호출을 종료하는 필요한 함수이다.
매개변수
- CallMgrVcContext
- 콜 매니저가 VC당 상태를 유지하는 콜 매니저 할당 컨텍스트 영역에 대한 핸들을 지정한다. 이 핸들은 콜 매니저들의 ProtocolCmMakeCall 함수로부터 NDIS에게 제공된다.
- CallMgrPartyContext
- 콜 매니저가 멀티 포인트 VC에서 파티에 대한 정보를 유지하는 콜 매니저 할당 컨텍스트 영역에 대한 핸들을 지정한다. 이 핸들은 만약 닫힌 호출이 멀티포인트 호출이 아니면 NULL이다.
- CloseData
- 호출이 종료되기 전에 연결을 통해 보내져야 하는 연결 지향 클라이언트 지정 데이터를 포함하는 버퍼를 가리킨다. 이 매개변수는 만약 아래 네트워크 미디엄이 연결을 닫을 때 데이터의 전송들을 지원하지 않으면 NULL이다.
- Size
- CloseData 버퍼의 바이트 길이를 지정한다. 만약 CloseData가 NULL이면 0이다.
리턴값
ProtocolCmCloseCall은 다음과 같은 하나의 값으로 연산의 상태를 리턴한다.
- NDIS_STATUS_SUCCESS
- 콜 매니저가 성공적으로 호출이 종료됐다는 것을 가리킨다.
- NDIS_STATUS_PENDING
- 콜 매니저는 비동기적으로 호출을 종료하기 위한 요구를 완성할 것이라는 것을 가리킨다. 콜 매니저가 연결을 종료하는데 필요한 모든 연산들을 완료할 때, 호출이 닫혔다는 것을 NDIS에게 신호화하기 위해 NdisCmCloseCallComplete 함수를 호출해야 한다.
- NDIS_STATUS_INVALID_DATA
- CloseData가 지정되었지만 아래 네트워크 미디엄이 호출을 종료하는 데 동반한 데이터를 보내는 것을 지원하지 않는다는 것을 가리킨다.
- NDIS_STATUS_XXX
- 콜 매니저는 호출을 종료할 수 없다는 것을 가리킨다. 실제 리턴된 에러는 또하나의 NDIS 라이브러리 루틴으로부터 전파되는 상태가 될 것이다.
주석
ProtocolCmCloseCall 함수는 로컬 노드와 리모트 노드사이에 연결을 종료하기 위해 미디어에 의해 필요로 되는 것처럼 네트워크 제어 장치들 혹은 다른 미디어 특정 actors들과 통신한다. 만약 콜 매니저가 네트워크 제어 장치들과 통신하기 위해 요구된다면, ProtocolBindAdapter 함수에서 설립된 네트워크 제어 장치에 가상 연결을 사용해야 한다. 혼자 작동하는 콜 매니저들은 NdisCoSendPackets 함수를 호출함으로써 그러한 네트워크 장치들과 통신한다. 통합 콜 관리를 하는 NIC 미니포트들은 결코 NdisCoSendPackets 함수들을 호출하는 것을 지원하지 않는다. 그 대신에, 그들은 직접 네트워크을 가로질러 데이터를 전송한다.
만약 CloseData가 NULL이 아니고 연결 종료에서 데이터를 보내는 것이 이러한 콜 매니저가 다루는 미디어에 의해 지원된다면, 콜 매니저는 호출 종료를 완성하기 전에 리모트 노드로 CloseData에 지원된 데이터를 전송해야 한다. 만약 연결과 동시에 데이터를 보내는 것이 지원되지 않는다면, 콜 매니저들은 NDIS_STATUS_INVALID_DATA를 리턴해야 한다.
ProtocolCmCloseCall 함수가 외연적인 CallMgrPartyContext를 전달되어진다면, 종료되는 호출은 멀티 포인트 VC이고 콜 매니저는 멀티 포인트 호출로서 호출을 종료하기 위해 미디어 타입에 적당한 네트워크 하드웨어와 어떤 필요한 네트워크 통신을 행해야 한다. 콜 매니저는 또한 CallMgrPartyContext에 의해 가리켜지는 파티당 상태를 위해 ProtocolCmMakeCall 함수에서 전에 할당한 메모리를 해제해야 한다. 이러한 자원들을 해제하고 할당 해제하고 비활성화하는 것에 대한 실패는 메모리 누수를 야기한다.
호출이 네트워크에서 종료된 후, 어떤 닫힌 데이터는 보내어지고 CallMgrPartyContext에 어떤 자원들은 해제되고 콜 매니저는 NdisCmDeactivateVc 함수를 호출해야 한다. 이것은 NDIS와 아래 NIC 미니포트에게 주어진 VC에서 더 이상 전송들이 기대되지 않는다라는 것을 주지한다.
ProtocolCmCloseCall 함수는 IRQL DISPATCH_LEVEL에서 실행될 수 있도록 쓰여져야 한다.
|