Share via


TSPI_lineSetCallParams (Compact 2013)

3/26/2014

This function sets certain parameters for an existing call.

Syntax

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

Parameters

  • dwRequestID
    Identifier of the asynchronous request.
  • hdCall
    Handle to the call whose parameters are to be changed. The call state can be any state except idle and disconnected.
  • dwBearerMode
    New bearer mode for the call. The dwBearerMode parameter can have only one of the LINEBEARERMODE constants.
  • dwMinRate
    Lower bound for the call's new data rate. TAPI can accept a new rate as low as this one. TAPI does not validate this parameter when this function is called.
  • dwMaxRate
    Upper bound for the call's new data rate. This is the maximum data rate TAPI would like. Equal values for dwMinRate and dwMaxRate indicate that an exact data rate is required. TAPI does not validate this parameter when this function is called.
  • lpDialParams
    Pointer to the new dial parameters for the call, of type LINEDIALPARAMS. If this parameter is NULL, it indicates that the call's current dialing parameters are to be used.

Return Value

Returns dwRequestID, or an error number if an error occurs. The lResult actual parameter of the corresponding ASYNC_COMPLETION is zero if the function succeeds, or an error number if an error occurs. The following table shows the return values for this function.

Value

Description

LINEERR_INVALCALLHANDLE

The handle to the call is invalid.

LINEERR_RATEUNAVAIL

The rate is unavailable.

LINEERR_INVALCALLSTATE

The call state is invalid.

LINEERR_NOMEM

Not enough memory is available.

LINEERR_INVALBEARERMODE

The bearer mode is invalid.

LINEERR_OPERATIONUNAVAIL

The operation is unavailable.

LINEERR_INVALPOINTER

The pointer is invalid.

LINEERR_OPERATIONFAILED

The operation failed.

LINEERR_INVALRATE

The rate is invalid.

LINEERR_RESOURCEUNAVAIL

The resource is unavailable.

LINEERR_BEARERMODEUNAVAIL

The bearer mode is unavailable.

Remarks

This operation is used to change the parameters of an existing call. Examples of its usage include changing the bearer mode and/or the data rate of an existing call.

Requirements

Header

tspi.h

Library

CellTSP.dll

See Also

Reference

TSPI Line Device Functions
TSPI_lineMakeCall