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_COMPLETIONの実際のパラメーター lResult は 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 メッセージを発行したり、その行のメッセージまたは状態データ構造の呼び出し数に含めたりすることはできません。