ProtocolCmIncomingCallComplete
VOID
ProtocolCmIncomingCallComplete(
IN NDIS_STATUS Status,
IN NDIS_HANDLE CallMgrVcContext,
IN PCO_CALL_PARAMETERS CallParameters
);
|
ProtocolCmIncomingCallComplete 함수는 NDIS에 의해 호출될 때, 콜 매니저에게 연결 지향 클라이언트가 콜 매니저가 전에 NdisCmDispatchingIncomingCall 함수를 통해 디스패치했던 들어오는 호출 제의의 처리를 마쳤다는 인디케이트하는데 필요한 함수이다.
매개변수
- Status
- 연결 지향 클라이언트에 대한 들어오는 호출을 디스패치하는 연산의 마지막 상태를 가리킨다.
- CallMgrVcContext
- 콜 매니저는 VC당 상태를 유지하는 콜 매니저 할당 컨텍스트 영역에 대한 핸들을 지정한다. 콜 매니저는 ProtocolCoCreateVc 함수로부터 이 핸들을 제공한다.
- CallParameters
- NdisCmDispatchIncomingCall에 대한 호출로 콜 매니저에 의해 지정된 콜 매개변수들을 가리킨다. 시그널링 프로토콜은 어느 호출 매개변수들이 콜 매니저가 변화할 수 있는지를 결정한다.
주석
연결 지향 클라이언트는 콜 매니저가 그것에 디스패치하는 들어오는 연결 제의의 처리를 완성했을 때, 이러한 루틴은 만약 NdisCmDispatchIncomingCall 함수가 NDIS_STATUS_PENDING를 리턴한다면, 호출될 것이다. 들어오는 호출의 마지막 상태가 Status내에 발견된다. Status를 위한 가능한 값들을 다음을 포함하지만 제한적이지 않다. :
- NDIS_STATUS_SUCCESS
- 콜 매니저가 들어오는 호출을 수락하는 것을 가리킨다.
- NDIS_STATUS_PENDING
- 호출이 디스패치하는 주소 패밀리 혹은 SAP가 현재 닫히는 과정에 있다는 것을 가리킨다.
- NDIS_STATUS_RESOURCES
- 들어오는 호출은 연결 지향 클라이언트가 동적으로 호출을 처리하기 위해 필요한 자원들을 할당할 수 없기 때문에 수락되지 않는다는 것을 가리킨다.
- NDIS_STATUS_INVALID_DATA
- 연결 지향 클라이언트는 지정된 콜 매개변수들이 유효하지 않기 때문에 호출을 거절한다는 것을 가리킨다.
만약 클라이언트가 들어오는 호출을 허락한다면, 콜 매니저는 호출이 수락했던 호출하는 엔티티로 인디케이트하기 위해 시그널링 메시지들을 보내야 한다. 만약 클라이언트가 호출을 수락하지 않는다면, 콜 매니저는 호출이 거절되었다는 것을 가리키기 위해 시그널링 메시지들을 보내야 한다.
ProtocolCmIncomingCallComplete 함수는 IRQL DISPATCH_LEVEL에서 실행될 수 있도록 써야 한다.
|