TSPI_lineSetCallParams関数 (tspi.h)

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

TSPI_lineSetCallParams関数は、既存の呼び出しに特定のパラメーターを設定します。

構文

LONG TSPIAPI TSPI_lineSetCallParams(
  DRV_REQUESTID          dwRequestID,
  HDRVCALL               hdCall,
  DWORD                  dwBearerMode,
  DWORD                  dwMinRate,
  DWORD                  dwMaxRate,
  LPLINEDIALPARAMS const lpDialParams
);

パラメーター

dwRequestID

非同期要求の識別子。

hdCall

パラメーターを変更する呼び出しのハンドル。呼び出し状態には、 アイドル状態 と切断状態を除く任意の状態を指定できます。

dwBearerMode

呼び出しの新しいベアラーモード。 dwBearerMode パラメーターには、LINEBEARERMODE_定数のいずれかを指定できます。

dwMinRate

呼び出しの新しいデータレートの下限。 TAPIは、このレートと同じくらい低い新しいレートを受け入れることができます。 TAPI は、この関数が呼び出されたときにこのパラメーターを検証しません。

dwMaxRate

呼び出しの新しいデータレートの上限。これは TAPI が望む最大データレートです。 dwMinRate と dwMaxRate の値が等しい場合は、正確なデータレートが必要であることを示します。 TAPI は、この関数が呼び出されたときにこのパラメーターを検証しません。

lpDialParams

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

戻り値

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

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