TSPI_lineAddToConference 함수(tspi.h)

아티클
08/26/2023

TSPI_lineAddToConference 함수는 hdConsultCall로 지정된 호출을 hdConfCall로 지정된 전화 회의에 추가합니다.

구문

LONG TSPIAPI TSPI_lineAddToConference(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdConfCall,
  HDRVCALL      hdConsultCall
);

매개 변수

dwRequestID

비동기 요청의 식별자입니다.

hdConfCall

전화 회의에 대한 핸들입니다. hdConfCall의 호출 상태는 OnHoldPendingConference 또는 onHold일 수 있습니다.

hdConsultCall

전화 회의에 추가할 호출에 대한 핸들입니다. 이 전화는 다른 회의의 부모이거나 회의에 참가할 수 없습니다. LINEADDRESSCAPS에 표시된 디바이스 기능에 따라 hdConsultCall 매개 변수가 반드시 TSPI_lineSetupConference 또는 TSPI_linePrepareAddToConference 사용하여 설정되지 않았을 수 있습니다. hdConsultCall의 호출 상태는 연결, onHold, 계속 또는 링백일 수 있습니다.

반환 값

오류가 발생하면 dwRequestID 또는 오류 번호를 반환합니다. 해당 ASYNC_COMPLETIONlResult 실제 매개 변수는 함수가 성공하면 0이거나 오류가 발생하면 오류 번호입니다. 가능한 반환 값은 다음과 같습니다.

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_CONFERENCEFULL, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM.

설명

서비스 공급자는 hdConsultCall이 다른 회의의 부모이거나 이미 회의에 참가한 경우 LINEERR_INVALCALLHANDLE 반환하거나, TSPI_lineSetupConference 또는 TSPI_linePrepareAddToConference 사용하여 설정해야 하는 등의 다른 이유로 hdConsultCall을 추가할 수 없습니다.

참고 추가된 파티의 통화 핸들은 회의에 통화를 추가한 후에도 유효합니다. 일반적으로 전화 회의의 상태가 연결되는 동안 상태가 회의됨으로 변경됩니다. 개별 참여 통화에 대한 핸들은 나중에 TSPI_lineRemoveFromConference 사용하여 전화 회의에서 해당 파티를 제거하는 데 사용할 수 있습니다.

회의에 참여하는 통화의 통화 상태는 독립적이지 않습니다. 예를 들어 전화 회의를 중단하면 참여하는 모든 통화가 자동으로 유휴 상태가 될 수 있습니다. TAPI는 라인의 디바이스 기능을 참조하여 사용할 수 있는 회의 제거 형식을 확인할 수 있습니다. TAPI 또는 해당 클라이언트 애플리케이션은 LINE_CALLSTATE 메시지를 추적하여 관련된 호출에 어떤 일이 발생했는지 확인해야 합니다.

전화 회의는 TSPI_lineSetupConference 또는 TSPI_lineCompleteTransfer 통해 설정됩니다. 일반적으로 회의에 추가된 통화는 TSPI_lineSetupConference 또는 TSPI_linePrepareAddToConference 사용하여 설정됩니다. 일부 스위치는 회의에 임의 통화를 추가할 수 있으며, 이러한 통화는 TSPI_lineMakeCall 사용하여 설정되었을 수 있으며 (하드) 보류 중일 수 있습니다. 회의의 일부인 모든 통화는 동일한 열린 줄에 있어야 합니다.

전화 회의의 모든 모니터링(미디어, 톤, 숫자)은 개별 참여 통화가 아닌 hdConfCall 매개 변수에만 적용됩니다.

이 함수는 TAPI 수준의 해당 함수와 같이 권한에 따라 제한이 없습니다. TAPI 함수에 대한 TSPI 대응이 없으므로 서비스 공급자가 "부모" 전화 회의 통화와 참가자 간의 관계를 추적해야 하는 명시적 요구 사항은 없습니다. 많은 서비스 공급자는 다른 전화 회의 관리 기능을 구현하기 위해 내부적으로 이러한 관계를 추적해야 할 수 있습니다.