TSPI_lineCompleteCall関数 (tspi.h)

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

TSPI_lineCompleteCall関数は、通常接続できない呼び出しを代わりに完了する方法を指定するために使用されます。ネットワークリソースがビジー状態であるか、リモートステーションがビジー状態であるか応答しないため、ネットワークまたはスイッチが呼び出しを完了できない場合があります。

構文

LONG TSPIAPI TSPI_lineCompleteCall(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  LPDWORD       lpdwCompletionID,
  DWORD         dwCompletionMode,
  DWORD         dwMessageID
);

パラメーター

dwRequestID

非同期要求の識別子。

hdCall

完了が要求された呼び出しに対するサービスプロバイダーのハンドル。 hdCall の呼び出し状態は、ビジー状態、リングバック状態、または続行状態のいずれかです。

lpdwCompletionID

サービスプロバイダーが完了識別子を書き込む DWORD サイズのメモリ位置へのポインター。これにより、 hdCall を含む行で進行中の完了要求が一意に識別されます。特に、要求が完了した後、または TSPI_lineUncompleteCall 関数を使用して取り消された後に、完了識別子が無効になります。サービスプロバイダーは、完了識別子が無効になるとすぐに自由に再利用できます。

dwCompletionMode

呼び出しを完了する方法。このパラメーターは、 LINECALLCOMPLMODE_定数の 1 つだけを使用します。

dwMessageID

LINECALLCOMPLMODE_MESSAGEを使用して呼び出しを完了するときに送信されるメッセージ。この識別子は、少数の定義済みメッセージからメッセージを選択します。このパラメーターは、この関数が呼び出されるときに TAPI によって検証されません。

戻り値

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

LINEERR_INVALCALLHANDLE、LINEERR_NOMEM、LINEERR_INVALCALLSTATE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALCALLCOMPLMODE、LINEERR_OPERATIONFAILED、LINEERR_INVALPOINTER、LINEERR_RESOURCEUNAVAIL、LINEERR_COMPLETIONOVERRUN、LINEERR_INVALMESSAGEID。

注釈

この関数は、要求がネットワークまたはスイッチによって受け入れられるときに完了したと見なされます。要求が指定された方法で完全に完了した場合はではありません。呼び出されたステーションまたはネットワークが、要求に応じて呼び出しを完了できる状態になると、サービスプロバイダーは、呼び出し状態がオファリングと等しいLINE_CALLSTATE メッセージを送信する必要があります。呼び出しの LINECALLINFO レコードは、呼び出しの理由を CALLCOMPLETION として一覧表示し、完了識別子も提供します。特定の時点で複数の呼び出し完了要求を未処理にできます。最大数はデバイスによって異なります。完了識別子は、個々の要求を参照するためにも使用されるため、TSPI_lineUncompleteCallを呼び出して要求を取り消すことができます。