TSPI_linePrepareAddToConference 함수(tspi.h)

아티클
08/26/2023

TSPI_linePrepareAddToConference 함수는 다른 당사자의 추가를 위해 기존 전화 회의를 준비합니다. 그것은 새로운 임시 상담 전화를 만듭니다. 새로운 상담 전화는 이후에 컨퍼런스 콜에 추가될 수 있습니다.

구문

LONG TSPIAPI TSPI_linePrepareAddToConference(
  DRV_REQUESTID          dwRequestID,
  HDRVCALL               hdConfCall,
  HTAPICALL              htConsultCall,
  LPHDRVCALL             lphdConsultCall,
  LPLINECALLPARAMS const lpCallParams
);

매개 변수

dwRequestID

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

hdConfCall

전화 회의에 대한 핸들입니다. hdConfCall의 호출 상태를 연결할 수 있습니다.

htConsultCall

새로운 임시 상담 통화에 대한 TAPI 핸들입니다. 서비스 공급자는 이를 저장하고 새 호출에서 이벤트를 보고하는 LINEEVENT 프로시저에 대한 모든 후속 호출에 사용해야 합니다. hdAddCall의 호출 상태는 적용되지 않습니다.

lphdConsultCall

새로운 임시 상담 호출에 대한 서비스 공급자의 식별자를 나타내는 HDRVCALL 에 대한 포인터입니다. 서비스 공급자는 이 프로시저가 반환되기 전에 새 호출에 대한 핸들로 이 위치를 채워야 합니다. 함수에 오류가 발생하면 이 핸들이 잘못되었습니다.

lpCallParams

상담 전화를 설정할 때 사용할 호출 매개 변수가 포함된 LINECALLPARAMS 에 대한 포인터입니다. 이 매개 변수는 특별한 호출 설정 매개 변수가 필요한 경우 NULL 로 설정됩니다.

반환 값

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

LINEERR_BEARERMODEUNAVAIL, LINEERR_INVALLINESTATE, LINEERR_CALLUNAVAIL, LINEERR_INVALMEDIAMODE, LINEERR_CONFERENCEFULL, LINEERR_INVALRATE, LINEERR_INUSE, LINEERR_NOMEM, LINEERR_INVALADDRESSMODE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALBEARERMODE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLPARAMS, LINEERR_RATEUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALCONFCALLHANDLE, LINEERR_USERUSERINFOTOOBIG.

설명

현재 이 작업을 수행할 수 있는 상태가 아닌 경우 서비스 공급자는 LINEERR_INVALLINESTATE 반환합니다. 서비스 공급자는 LINEDEVSTATUS 구조체의 dwLineFeatures 멤버(LINEFEATURE 형식)에서 현재 유효한 작업 목록을 표시해야 합니다.

전화 회의 호출이 요청된 작업에 유효한 상태가 아닌 경우 서비스 공급자는 LINEERR_INVALCALLSTATE 반환합니다.

이 함수는 onHoldPendingConference 상태에 기존 전화 회의를 배치하고 나중에 TSPI_lineAddToConference 기존 전화 회의에 추가할 수 있는 상담 전화를 만듭니다.

상담 전화는 TSPI_lineDrop 사용하여 취소할 수 있습니다. TAPI가 상담 전화와 TSPI_lineSwapHold 열린 컨퍼런스 콜 간에 교환할 수도 있습니다. 서비스 공급자는 처음에 줄에서 모니터링된 미디어 유형 집합 이상에 대해 새 호출에 대한 미디어 모니터링을 수행합니다.

이 함수는 호출 수명을 시작하기 위해 TSPI 모델을 따른다는 점에서 해당 TAPI 함수와 다릅니다. TAPI 및 서비스 공급자는 서로 호출을 나타내는 불투명 핸들을 교환합니다. 또한 서비스 공급자는 이 절차에서 반환되기 전에 새 호출에 대한 콜백을 수행할 수 있습니다. 어쨌든 서비스 공급자는 일치하는 ASYNC_COMPLETION 메시지가 성공을 보고할 때까지 반환된 핸들을 "아직 유효하지 않음"으로 처리해야 합니다. 즉, 새 호출에 대한 LINEEVENT 메시지를 발급하거나 메시지의 호출 수 또는 줄에 대한 상태 데이터 구조에 포함해서는 안 됩니다.