NdisCmDispatchIncomingCall

NDIS_STATUS 

  NdisCmDispatchIncomingCall(

    IN NDIS_HANDLE  NdisSapHandle,

    IN NDIS_HANDLE  NdisVcHandle,

    IN PCO_CALL_PARAMETERS  CallParameters

    );

NdisCmDispatchIncomingCall함수는 클라이언트에게 그 클라이언트에의해 이전에 등록된 SAP의 들어오는 호출을 알린다.

매개변수

NdisSapHandle
SAP를 확인하는 핸들을 지정한다. 클라이언트가 처음에 NdisClRegisterSap함수를 호출했을때, 콜 매니저가 처음에 ProtocolCmRegisterSap함수의 입력 파라미터로써 이핸들을 얻었을때 NDIS는 이 핸들을 설정한다.

NdisVcHandle
콜 매니저가 이 등록된 SAP로 인도되는 들어오는 호출 제안을 처리할때 NdisCoCreateVc 함수로 만들어진 VC를 확인하기위한 핸들을 지정한다.

CallParameters
VC에대한 트래픽과 미디어 파라미터들을 지정하는 CO_CALL_PARAMETERS타입 구조체의 포인터.

리턴값

NdisCmDispatchIncomingCall함수가 NDIS_STATUS_PENDING이외의 다른것을 리턴할때, 콜 매니저는 ProtocolCmIncomingCallComplete함수의 내부적인 호출을 만들어야한다. 그렇지 않으면, NDIS는 이 연산이 완료될때, CM의 ProtocolCmIncomingCallComplete함수를 호출한다.

주석

NdisCmDispatchIncomingCall함수의 호출전에, 독립적인 콜 매니저는 이미 다음것을 행한다.:

  • 네트웍 상으로 받은 콜(실제로 연결을 만들기 위한 요청)에대해 고유한 클라이언트에의해 이전에 등록된 타겟 SAP를확인한다.

  • NdisCoCreateVc함수로 들어오는 호출에대한 VC를 생성한다.

  • 네트웍 사으로 콜 파라미터들의 허용 가능성에대해 협상을 하거나, 리모트 노드로 부터 보내진 콜 파라미터를 수용한다.

  • 하위 닉 드라이버로 하여금 스스로 협상되거나 수용된 콜 파라미터들에따른 VC로의 전송에대해 준비하도록 하면서 NdisCmActivateVc함수로 VC를 활성화 한다.

CM의 NdisCmDispatchIncomingCall함수의 호출은 클라이언트가 요청된 연결을 받아들이거나 거절하는것내에서 NDIS가 클라이언트의 ProtocolClIncomingCall함수를 호출하도록 한다. 연결을 받아들일것인지를 결정한후에, 클라이언트는 NdisClIncomingCallComplete함수를 호출한다. 다음으로 이것은 CM의 ProtocolCmIncomingCallComplete함수를 호출한다. 만약 클라이언트가 콜을 받아들인다면, CM은 다음에 NdisCmDispatchCallConnected함수를 호출한다. 그렇지 않으면, 리모트 노드에게 제안된 콜을 거절한다는 것을 알리난후 생성한 VC를 비 활성화(그리고 가능하면 지우고)한다.

단지 스스로 NDIS로 프로토콜로써 등록하는 독립적인 콜 매니저만이 NdisCmDispatchIncomingCall함수를 호출할수있다. 통합 콜 매니지먼트를 지원하는 연결지향 닉 미니포트는 대신에 NdisMCmDispatchIncomingCall함수를 호출한다.

NdisCmDispatchIncomingCall함수의 호출자는 IRQL <= DISPATCH_LEVEL에서 동작될수있다.