NdisMCmDispatchIncomingCall

NDIS_STATUS

  NdisMCmDispatchIncomingCall(

    IN NDIS_HANDLE  NdisSapHandle,

    IN NDIS_HANDLE  NdisVcHandle,

    IN PCO_CALL_PARAMETERS  CallParameters

    );

NdisMCmDispatchIncomingCall함수는 MCM드라이버로 클라이언트에의해 이전에 등록된 SAP에 들어오는 호출을 클라이언트에게 알려준다.

매개변수

NdisSapHandle
SAP를 확인하는 핸들을 지정한다. 클라이언트가 처음에 NdisClRegisterSap함수를 호출할때 NDIS는 이 핸들을 설정한다. 그리고 그 MCM미니포트는 이 핸들을 ProtocolCmRegisterSap함수에대한 입력 파라미터로써 얻는다.

NdisVcHandle
VC를 확인하는 핸들을 지정한다. MCM드라이버가 이 등록된 SAP로 다이렉트된 들어오는 호출제안을 처리할때 NdisMCmCreateVc함수로 생성된다.

CallParameters
VC에대한 호출과 미디어 파라미터를 지정하는 CO_CALL_PARAMETERS타입의 구조체를 가리킨다.

리턴값

NdisMCmDispatchIncomingCall함수는 NDIS_STATUS_PENDING이외의 상태를 리턴한다. MCM드라이버는 ProtocolCmIncomingCallComplete함수에대한 내부적인 호출을 만들어야한다. 그렇지 않으면, NDIS는 이 연산이 완료될때, MCM미니포트의 ProtocolCmIncomingCallComplete함수를 호출한다.

주석

NdisMCmDispatchIncomingCall함수의 호출전에, MCM드라이버는 이미 다음을 행한다.:

  • 이전에 특정한 클라이언트에의해 등록된 타겟 SAP를 확인한다. 네트웍상으로 받은 호출(실제로, 연결설정에대한 요구)에대해

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

  • 네트웍상으로 수용할수 있는 콜 파라미터들에대해 협상하거나 리모트 노드로부터 보내진 콜 파라미터를 수용한다.

  • 협상되고 수용된 콜 파라미터와의 일치한 VC로 전송준비한다는것을 NDIS알리기위해 NdisMCmActivateVc함수로 VC를 활성화 한다.

MCM드라이버의 NdisMCmDispatchIncomingCall함수의 호출은 NDIS로 하여금 클라이언트의 ProtocolClIncomingCall함수를 호출하도록 한다. 클라이언트는 요청된 연결을 수용하거나 거절하는것에 한하여. 연결을 수용할지를 결정한후, MCM드라이버는 NdisMCmDispatchCallConnected함수를 호출한다. 그렇지 않으면, 리모트 노드에게 제안된 호출을 알린후 생성된 VC를 비활성화(지울수도 있다.)한다.

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

NdisMCmDispatchIncomingCall함수의 호출은 IRQL <= DISPATCH_LEVEL에서 동작될수 있다.