TSPI_linePark関数 (tspi.h)

[アーティクル]
08/26/2023

TSPI_linePark関数は、指定したパークモードに従って、指定した呼び出しをパークします。

構文

LONG TSPIAPI TSPI_linePark(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  DWORD         dwParkMode,
  LPCWSTR       lpszDirAddress,
  LPVARSTRING   lpNonDirAddress
);

パラメーター

dwRequestID

非同期要求の識別子。

hdCall

パークする呼び出しのハンドル。 hdCall の呼び出し状態は接続できます。

dwParkMode

呼び出しをパークするパークモード。 LINEPARKMODE_定数の 1 つだけ。

lpszDirAddress

ダイレクトパークを使用するときに呼び出しをパークするアドレスを示す null で終わる Unicode 文字列へのポインター。アドレスはダイヤル可能なアドレス形式です。このパラメーターは、無向公園では無視されます。

lpNonDirAddress

VARSTRING 型の構造体へのポインター。無方向パークの場合、コールがパークされるアドレスがこの構造体で返されます。このパラメーターは、指定されたパークでは無視されます。 VARSTRING 構造体内では、dwStringFormat を STRINGFORMAT_ASCII (null で終わる文字列を含む ASCII 文字列バッファー) に設定する必要があり、終了する NULL は dwStringSize で考慮されます。 lpNonDirAddress パラメーターが指すメモリが要求されたアドレスに対して十分な大きさでない場合、TSPI_linePark関数はLINEERR_STRUCTURETOOSMALLを返します。

戻り値

dwRequestID を返します。エラーが発生した場合はエラー番号を返します。関数が成功した場合は対応するASYNC_COMPLETIONの実際のパラメーター lResult は 0、エラーが発生した場合はエラー番号です。可能な戻り値は次のとおりです。

LINEERR_INVALCALLHANDLE、LINEERR_NOMEM、LINEERR_INVALPARKMODE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALCALLSTATE、LINEERR_OPERATIONFAILED、LINEERR_INVALADDRESS、LINEERR_RESOURCEUNAVAIL、LINEERR_STRUCTURETOOSMALL。

注釈

dwTotalSize を除く VARSTRING 構造体のすべてのメンバーは、サービスプロバイダーによって入力されます。 dwTotalSize メンバーは TAPI によって入力され、サービスプロバイダーはこの値を上書きしないでください。

ダイレクトパークでは、クライアントアプリケーション (TAPI を使用) によって、呼び出しをパークするアドレスが指定されます。無向公園では、スイッチによってアドレスが決定され、TAPI に提供されます。どちらの場合も、このアドレスを指定することで、パークされた呼び出しを解除できます。

通常、パークされた呼び出しは、正常にパークされた後に アイドル状態 になります。サービスプロバイダーは、 LINE_CALLSTATE メッセージを使用して新しい状態を報告します。後続の TSPI_lineUnpark では、古いハンドルが破棄されたかどうかに関係なく、新しい個別の呼び出しハンドルTSPI_lineCloseCall 作成されます。

一部のスイッチでは、通話が長時間パークされた後にユーザーに通知できます。サービスプロバイダーは、呼び出しの理由がアラームに設定されたオファリング呼び出しとして TAPI にこれを報告します (これがわかっていれば)。