TSPI_lineSetCallParams
The TSPI_lineSetCallParams function sets certain parameters for an existing call.
LONG TSPI_lineSetCallParams(
DRV_REQUESTID dwRequestID,
HDRVCALL hdCall,
DWORD dwBearerMode,
DWORD dwMinRate,
DWORD dwMaxRate,
LPLINEDIALPARAMS const lpDialParams
);
Parameters
-
dwRequestID
-
The identifier of the asynchronous request.
-
hdCall
-
The handle to the call whose parameters are to be changed. The call state can be any state except idle and disconnected.
-
dwBearerMode
-
The new bearer mode for the call. The dwBearerMode parameter can have only one of the following LINEBEARERMODE_flags set:
-
LINEBEARERMODE_VOICE
-
A regular 3.1kHz analog voice grade bearer service. Bit integrity is not assured. Voice can support fax and modem media modes.
-
LINEBEARERMODE_SPEECH
-
Corresponds to G.711 speech transmission on the call. The network can use processing techniques such as analog transmission, echo cancellation and compression/decompression. Bit integrity is not assured. Speech is not intended to support fax and modem media modes.
-
LINEBEARERMODE_MULTIUSE
-
The multiuse mode defined by ISDN.
-
LINEBEARERMODE_DATA
-
The unrestricted data transfer on the call. The data rate is specified separately.
-
LINEBEARERMODE_ALTSPEECHDATA
-
The alternate transfer of speech or unrestricted data on the same call (ISDN).
-
LINEBEARERMODE_NONCALLSIGNALING
-
Corresponds to a non-call-associated signaling connection from the application to the service provider or switch (treated as a media stream by TAPI).
-
LINEBEARERMODE_PASSTHROUGH
-
When a call is active in LINEBEARERMODE_PASSTHROUGH, the service provider gives direct access to the attached hardware for control by the application. This mode is used primarily by applications desiring temporary direct control over asynchronous modems, accessed through the Win32 comm functions, for the purpose of configuring or using special features not otherwise supported by the service provider.
-
dwMinRate
-
A 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
-
An 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
-
A 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 Values
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. Possible return values are as follows:
LINEERR_INVALCALLHANDLE, LINEERR_RATEUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_NOMEM, LINEERR_INVALBEARERMODE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALPOINTER, LINEERR_OPERATIONFAILED, LINEERR_INVALRATE, LINEERR_RESOURCEUNAVAIL, LINEERR_BEARERMODEUNAVAIL.
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.
See Also
ASYNC_COMPLETION, LINECALLPARAMS, LINEDIALPARAMS, TSPI_lineMakeCall