Skip to content

Latest commit

 

History

History
105 lines (74 loc) · 3.54 KB

nf-tapi-linesetcallparams.md

File metadata and controls

105 lines (74 loc) · 3.54 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:tapi.lineSetCallParams
lineSetCallParams function (tapi.h)
The lineSetCallParams function allows an application to change bearer mode and/or the rate parameters of an existing call.
_tapi2_linesetcallparams
lineSetCallParams
lineSetCallParams function [TAPI 2.2]
tapi/lineSetCallParams
tapi2.linesetcallparams
tapi2\linesetcallparams.htm
tapi3
c8088116-2bfc-420f-a83a-d00c7947b6e7
12/05/2018
_tapi2_linesetcallparams, lineSetCallParams, lineSetCallParams function [TAPI 2.2], tapi/lineSetCallParams, tapi2.linesetcallparams
tapi.h
Windows
Tapi32.lib
Tapi32.dll
Windows
19H1
lineSetCallParams
tapi/lineSetCallParams
c++
APIRef
kbSyntax
DllExport
Tapi32.dll
lineSetCallParams

lineSetCallParams function

-description

The lineSetCallParams function allows an application to change bearer mode and/or the rate parameters of an existing call.

-parameters

-param hCall

Handle to the call whose parameters are to be changed. The application must be an owner of the call. The call state of hCall can be any state except idle or disconnected.

-param dwBearerMode

New bearer mode for the call. This parameter uses one and only one of the LINEBEARERMODE_ Constants.

-param dwMinRate

Lower bound for the call's new data rate. The application can accept a new rate as low as this one.

-param dwMaxRate

Upper bound for the call's new data rate. This is the maximum data rate the application can accept. If an exact data rate is required, dwMinRate and dwMaxRate should be equal.

-param lpDialParams

Pointer to the new dial parameters for the call, of type LINEDIALPARAMS. This parameter can be left NULL if the call's current dialing parameters are to be used.

-returns

Returns a positive request identifier if the function is completed asynchronously, or a negative error number if an error occurs. The dwParam2 parameter of the corresponding LINE_REPLY message is zero if the function succeeds or it is a negative error number if an error occurs. Possible return values are:

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.

-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

LINEDIALPARAMS

LINE_REPLY

Supplementary Line Service Functions

TAPI 2.2 Reference Overview