ProtocolClIncomingCall

NDIS_STATUS ProtocolClIncomingCall( IN NDIS_HANDLE ProtocolSapContext, IN NDIS_HANDLE ProtocolVcContext, IN OUT PCO_CALL_PARAMETERS CallParameters );

들어오는 호출들을 수락하는 연결 지향 클라이언트들은 ProtocolClIncomingCall 함수들을 가져야 한다. 그렇지 않으면, 그러한 프로토콜 드라이버의 등록된 ProtocolClIncomingCall 함수는 간단히 NDIS_STATUS_NOT_SUPPORTED를 리턴할 수 있다.

매개변수

ProtocolSapContext

클라이언트가 원래 콜 매니저가 이러한 들어오는 호출 제의에 대해 일치하는 SAP를 등록할 때 제공하는 핸들을 지정한다.

ProtocolVcContext

전에 ProtocolCoCreateVc 함수에 의해 NDIS에게 리턴된 클라이언트의 VC당 컨텍스트 영역에 대한 핸들을 지정한다.

CallParameters

이러한 제공된 호출을 위한 콜 매개변수들을 포함하는 CO_CALL_PARAMETERS 구조체로 포맷된 버퍼를 가리킨다.

리턴값

ProtocolClIncomingCall은 만약 클라이언트가 들어오는 호출 제의를 수락한다면 NDIS_STATUS_SUCCESS를 리턴한다. 어떤 다른 클라이언트 결정 상태는 제공된 호출의 거절을 가리킨다.

주석

ProtocolClIncomingCall에 대한 호출은 콜 매니저가 이러한 클라이언트와 연결을 설립하기 위한 시그너링 피어로부터 네트워크에서 요구를 수락한다는 것을 가리킨다. 즉, 그러한 연결을 설정하기 위한 요구가 전에 이러한 클라이언트에 의해 콜 매니저에게 등록된 SAP에게 지시되어진다.

콜 매니저에 의해 제공된 시그널링 프로토콜에 의존하는 ProtocolClIncomingCall 함수는 들어오는 호출의 수락을 협상하는 과정의 부분으로 트래픽 매개변수들을 수정할 수 있고/있거나 만약 CallParameters에 서비스 사양의 질, 콜 매니저가 QoS를 지원한다면,

클라이언트는 만약 제공된 호출을 수락한다면 이러한 버퍼화된 구조체로부터 계속적으로 필요한 어떤 정보를 복사해야 한다. 콜 매니저가 클라이언트의 어쩠든 수락할 수 있는 수정들을 발견한다고 추측하면, NDIS는 다음 원래 호출 제의(offer)를 초기화하는 리모트 노드에서 클라이언트에 대한 연결을 표시하는 활성화 VC에서 일어나는 전송들이 가능할 때 클라이언트의 ProtocolClIncomingCallConnected 함수를 호출한다. 만약 클라이언트가 수락할 수 없는 수정된 호출 매개변수들을 리턴한다면 콜 매니저는 대신에 클라이언트의 ProtocolClIncomingCloseCall 함수에 대한 호출 그리고 다음에 ProtocolCoDeleteVc 함수들에 대한 호출을 야기하면서 이러한 제의를 위해 만들어진 VC를 끊을 수 있다.

ProtocolClIncomingCall 함수는 IRQL DISPATCH_LEVEL에서 실행할 수 있게 쓰여져야 한다.