Share via


lineSetCallParams

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

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

Syntax

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

Parameters

  • 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.
  • dwBearerMode
    New bearer mode for the call. This parameter uses one and only one of the LINEBEARERMODE.
  • dwMinRate
    Lower bound for the call's new data rate. The application can accept a new rate as low as this one.
  • 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.
  • 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.

Return Value

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. The following table shows the return values for this function.

Value Description

LINEERR_BEARERMODEUNAVAIL

The bearer mode member in the LINECALLPARAMS structure is invalid, the bearer mode specified in LINECALLPARAMS is not available, or the call's bearer mode cannot be changed to the specified bearer mode.

LINEERR_NOTOWNER

The application is not the owner of the call.

LINEERR_INVALBEARERMODE

The bearer mode is invalid.

LINEERR_OPERATIONUNAVAIL

The operation is invalid.

LINEERR_INVALCALLHANDLE

The call handle is invalid.

LINEERR_RATEUNAVAIL

The rate is unavailable.

LINEERR_INVALRATE

The rate is invalid.

LINEERR_NOMEM

Not enough memory is available.

LINEERR_OPERATIONFAILED

The operation failed.

LINEERR_RESOURCEUNAVAIL

The resource is unavailable.

LINEERR_UNINITIALIZED

The parameter is uninitialized.

LINEERR_INVALCALLSTATE

The call state is invalid.

LINEERR_INVALPOINTER

The pointer is invalid.

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 tapi.h
Library coredll.lib
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

LINE_REPLY