TSPI_lineAddToConference関数 (tspi.h)

[アーティクル]
03/13/2024

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_COMPLETIONの lResult 実際のパラメーターは 0、エラーが発生した場合はエラー番号です。可能な戻り値は次のとおりです。

LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALCALLSTATE、LINEERR_OPERATIONFAILED、LINEERR_CONFERENCEFULL、LINEERR_RESOURCEUNAVAIL、LINEERR_NOMEM。

注釈

hdConsultCall が別の会議の親であるか、既に会議に参加している場合、または hdConsultCall がTSPI_lineSetupConferenceまたはTSPI_linePrepareAddToConferenceを使用して確立されている必要があるなどのその他の理由で追加できない場合、サービスプロバイダーはLINEERR_INVALCALLHANDLEを返します。

メモ追加されたパーティの通話ハンドルは、電話会議に通話を追加した後も有効なままです。通常、その状態は会議に変わり、電話会議の状態は 接続されます。参加している個々の通話へのハンドルは、後で TSPI_lineRemoveFromConference を使用して電話会議からそのパーティーを削除するために使用できます。

会議に参加している通話の通話状態は独立していません。たとえば、電話会議を削除すると、参加しているすべての通話が自動的に アイドル状態になることがあります。 TAPI は、回線のデバイス機能を調べて、使用可能な会議の削除の形式を決定できます。 TAPI またはそのクライアントアプリケーションは、関連する呼び出しに何が起こったかを判断するために、LINE_CALLSTATE メッセージを追跡する必要があります。

電話会議は、 TSPI_lineSetupConference または TSPI_lineCompleteTransferを介して確立されます。通常、会議に追加される通話は、 TSPI_lineSetupConference または TSPI_linePrepareAddToConferenceを使用して確立されます。一部のスイッチでは、電話会議に任意の通話を追加できる場合があり、そのような通話は TSPI_lineMakeCall を使用して設定され、(ハード) ホールドされている可能性があります。会議の一部であるすべての通話は、同じ開いている回線に存在する必要があります。

電話会議の監視 (メディア、トーン、数字) は、参加している個々の呼び出しではなく、 hdConfCall パラメーターにのみ適用されます。

この関数には、TAPI レベルの対応する関数のように、特権に基づく制限はありません。 TAPI 関数への TSPI 対応がないため、サービスプロバイダーが "親" 電話会議とその参加者との関係を追跡する明示的な要件はありません。多くのサービスプロバイダーは、他の電話会議管理機能を実装するために、これらの関係を内部的に追跡する必要がある場合があります。