lineSetCallParams 関数 (tapi.h)

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

lineSetCallParams 関数を使用すると、アプリケーションでベアラーモードや既存の呼び出しのレートパラメーターを変更できます。

構文

LONG lineSetCallParams(
  HCALL                  hCall,
  DWORD                  dwBearerMode,
  DWORD                  dwMinRate,
  DWORD                  dwMaxRate,
  LPLINEDIALPARAMS const lpDialParams
);

パラメーター

hCall

パラメーターを変更する呼び出しを処理します。アプリケーションは、呼び出しの所有者である必要があります。 hCall の呼び出し状態は、アイドル状態または切断状態を除く任意の状態にすることができます。

dwBearerMode

呼び出しの新しいベアラーモード。このパラメーターは、 LINEBEARERMODE_定数の 1 つだけを使用します。

dwMinRate

呼び出しの新しいデータレートの下限。アプリケーションは、このレートと同じくらい低い新しいレートを受け入れます。

dwMaxRate

呼び出しの新しいデータレートの上限。これは、アプリケーションが受け入れることができる最大データレートです。正確なデータレートが必要な場合は、 dwMinRate と dwMaxRate が等しい必要があります。

lpDialParams

LINEDIALPARAMS 型の呼び出しの新しいダイヤルパラメーターへのポインター。呼び出しの現在のダイヤルパラメーターを使用する場合は、このパラメーターを NULL のままに することができます。

戻り値

関数が非同期的に完了した場合は正の要求識別子を返し、エラーが発生した場合は負のエラー番号を返します。関数が成功した場合は、対応するLINE_REPLY メッセージの dwParam2 パラメーターは 0、エラーが発生した場合は負のエラー番号です。可能な戻り値は次のとおりです。

LINEERR_BEARERMODEUNAVAIL、LINEERR_NOTOWNER、LINEERR_INVALBEARERMODE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONFAILED、LINEERR_INVALCALLSTATE、LINEERR_RATEUNAVAIL、LINEERR_INVALPOINTER、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALRATE、LINEERR_UNINITIALIZED、LINEERR_NOMEM。