<div class="content" name="SetCallParams" uuid="195b0fa7-17b9-4b69-a0ef-903b27f28d66"><p>The SetCallParams packet is transmitted from a TAPI <a href="489de77f-16d8-4c4f-939a-f795e8b42893#gt_60e0e1fa-66fe-41e1-b5e3-ceab97e53506" data-linktype="relative-path">client</a> to a TAPI <a href="489de77f-16d8-4c4f-939a-f795e8b42893#gt_434b0234-e970-4e8c-bdfa-e16a30d96703" data-linktype="relative-path">server</a> in a <a href="489de77f-16d8-4c4f-939a-f795e8b42893#gt_8a7f6700-8311-45bc-af10-82e10accd331" data-linktype="relative-path">remote procedure call</a>.
Sending this packet allows an application to change the bearer mode, rate
parameters, and dial parameters of an existing call.</p><table>
 <tbody><tr>
  <th><p><br/>0</p></th>
  <th><p><br/>1</p></th>
  <th><p><br/>2</p></th>
  <th><p><br/>3</p></th>
  <th><p><br/>4</p></th>
  <th><p><br/>5</p></th>
  <th><p><br/>6</p></th>
  <th><p><br/>7</p></th>
  <th><p><br/>8</p></th>
  <th><p><br/>9</p></th>
  <th><p>1<br/>0</p></th>
  <th><p><br/>1</p></th>
  <th><p><br/>2</p></th>
  <th><p><br/>3</p></th>
  <th><p><br/>4</p></th>
  <th><p><br/>5</p></th>
  <th><p><br/>6</p></th>
  <th><p><br/>7</p></th>
  <th><p><br/>8</p></th>
  <th><p><br/>9</p></th>
  <th><p>2<br/>0</p></th>
  <th><p><br/>1</p></th>
  <th><p><br/>2</p></th>
  <th><p><br/>3</p></th>
  <th><p><br/>4</p></th>
  <th><p><br/>5</p></th>
  <th><p><br/>6</p></th>
  <th><p><br/>7</p></th>
  <th><p><br/>8</p></th>
  <th><p><br/>9</p></th>
  <th><p>3<br/>0</p></th>
  <th><p><br/>1</p></th>
 </tr>
 <tr>
  <td colspan="32">Req_Func</td>
 </tr>
 <tr>
  <td colspan="32">Reserved1</td>
 </tr>
 <tr>
  <td colspan="32">dwRequestID</td>
 </tr>
 <tr>
  <td colspan="32">hCall</td>
 </tr>
 <tr>
  <td colspan="32">dwBearerMode</td>
 </tr>
 <tr>
  <td colspan="32">dwMinRate</td>
 </tr>
 <tr>
  <td colspan="32">dwMaxRate</td>
 </tr>
 <tr>
  <td colspan="32">lpDialParams</td>
 </tr>
 <tr>
  <td colspan="32">dwSize</td>
 </tr>
 <tr>
  <td colspan="32">Reserved2</td>
 </tr>
 <tr>
  <td colspan="32">Reserved3</td>
 </tr>
 <tr>
  <td colspan="32">Reserved4</td>
 </tr>
 <tr>
  <td colspan="32">Reserved5</td>
 </tr>
 <tr>
  <td colspan="32">Reserved6</td>
 </tr>
 <tr>
  <td colspan="32">Reserved7</td>
 </tr>
 <tr>
  <td colspan="32">VarData (16 bytes, optional)</td>
 </tr>
 <tr>
  <td colspan="32">...</td>
 </tr>
 <tr>
  <td colspan="32">...</td>
 </tr>
</tbody></table><p><b>Req_Func (4 bytes): </b>An unsigned 32-bit
integer. The identifier of the function that will be invoked on the remote
server. This value MUST be set to 72. </p><dl>
<dd>
<p><b>Return Values</b></p>
</dd>
<dd>
<p>On completion of <a href="c28c36d0-579b-4e20-a100-f4e71012d5f8" data-linktype="relative-path">ClientRequest</a>, this field
contains the result of the encapsulated telephony request. A nonzero request ID
value indicates that the request is in progress and will complete asynchronously,
and a <a href="e0e8af90-24f1-4dbc-8d4e-01b8e4e7cb53" data-linktype="relative-path">LINEERR_Constants</a>
value indicates synchronous failure.</p>
</dd>
<dd>
<p>Returns a positive request identifier if the
function will be completed asynchronously or a negative error number if an
error occurs. The dwParam2 parameter of the corresponding <a href="8f5bc349-fd55-46f2-b0bc-dc9f757317a9" data-linktype="relative-path">LINE_REPLY</a> packet is zero
if the function succeeds, or it is a negative error number if an error occurs.
If the client specified a nonzero value in the dwRequestID field of the packet,
the same value MUST be used for the returned positive request identifier. The
following table shows the return values for this function.</p>
</dd>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Value</p>
   </th>
   <th>
   <p>Meaning</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>LINEERR_BEARERMODEUNAVAIL 0x80000003</td>
  <td>The bearer mode member in the LINECALLPARAMS packet is invalid, the bearer mode that is specified in LINECALLPARAMS is not available, or the bearer mode of the call cannot be changed to the specified bearer mode.</td>
 </tr><tr>
  <td>LINEERR_NOTOWNER 0x80000046</td>
  <td>The application is not the owner of the call.</td>
 </tr><tr>
  <td>LINEERR_INVALBEARERMODE 0x80000016</td>
  <td>The bearer mode is invalid.</td>
 </tr><tr>
  <td>LINEERR_OPERATIONUNAVAIL 0x80000049</td>
  <td>The operation is invalid.</td>
 </tr><tr>
  <td>LINEERR_INVALCALLHANDLE 0x80000018</td>
  <td>The call handle is invalid.</td>
 </tr><tr>
  <td>LINEERR_RATEUNAVAIL 0x8000004A</td>
  <td>The rate is unavailable.</td>
 </tr><tr>
  <td>LINEERR_INVALRATE 0x80000037</td>
  <td>The rate is invalid.</td>
 </tr><tr>
  <td>LINEERR_NOMEM 0x80000044</td>
  <td>Not enough memory is available.</td>
 </tr><tr>
  <td>LINEERR_OPERATIONFAILED 0x80000048</td>
  <td>The operation failed.</td>
 </tr><tr>
  <td>LINEERR_RESOURCEUNAVAIL 0x8000004B</td>
  <td>The resource is unavailable.</td>
 </tr><tr>
  <td>LINEERR_UNINITIALIZED 0x80000050</td>
  <td>The parameter is uninitialized.</td>
 </tr><tr>
  <td>LINEERR_INVALCALLSTATE 0x8000001C</td>
  <td>The call state is invalid.</td>
 </tr><tr>
  <td>LINEERR_INVALPOINTER 0x80000035</td>
  <td>The pointer is invalid.</td>
 </tr></tbody></table>
</dd></dl><p><b>Reserved1 (4 bytes): </b>An unsigned 32-bit
integer. MUST be set to zero when sent and MUST be ignored on receipt. </p><p><b>dwRequestID (4 bytes): </b>An unsigned 32-bit
integer. The identifier of the asynchronous request. </p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Value</p>
   </th>
   <th>
   <p>Meaning</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>0x00000000</td>
  <td>The server MUST generate a unique positive request ID to return as the Ack_ReturnValue.</td>
 </tr><tr>
  <td>0x00000001 — 0x7FFFFFFF</td>
  <td>The server MUST use this value instead of generating a unique positive request ID.</td>
 </tr></tbody></table>
</dd></dl><p><b>hCall (4 bytes): </b>An <a href="7f4089a0-7432-4ef0-8eeb-5aafe407c07e" data-linktype="relative-path">HCALL</a>. The handle to the
call whose parameters are to be changed. One way of obtaining a valid hCall is
by sending the <a href="c9acdfde-22de-43ff-b491-23a9ed72fb31" data-linktype="relative-path">MakeCall</a>
packet. Also a valid hCall can be obtained from <a href="0a8905e3-647f-4e98-aca8-2fa77eedb2e7" data-linktype="relative-path">LINE_CALLSTATE</a> packet sent
by the remote server. The application MUST be an owner of the call. The call
state of hCall can be any state except idle or disconnected. </p><p><b>dwBearerMode (4 bytes): </b>An unsigned 32-bit
integer. The new bearer mode for the call. This field MUST use one of the <a href="e184f4e2-01dc-4189-859d-62dd27bb632b" data-linktype="relative-path">LINEBEARERMODE_Constants</a>. </p><p><b>dwMinRate (4 bytes): </b>An unsigned 32-bit
integer. The lower bound for the new data rate of the call. </p><p><b>dwMaxRate (4 bytes): </b>An unsigned 32-bit
integer. The upper bound for the new data rate of the call. </p><p><b>lpDialParams (4 bytes): </b>An unsigned 32-bit
integer. The offset, in bytes, in the VarData field of a <a href="6478c927-0d4b-43eb-8188-e87431058e6a" data-linktype="relative-path">LINEDIALPARAMS</a> packet that
contains the new dial parameters of the call. If this field is -1 (0xFFFFFFFF),
no call parameter is sent.</p><p><b>dwSize (4 bytes): </b>An unsigned 32-bit integer.
The size, in bytes, of the packet that is indicated in the lpDialParams field.</p><p><b>Reserved2 (4 bytes): </b>An unsigned 32-bit
integer. This field is used for padding and MUST be ignored on receipt. It can
be any value.</p><p><b>Reserved3 (4 bytes): </b>An unsigned 32-bit
integer. This field is used for padding and MUST be ignored on receipt. It can
be any value.</p><p><b>Reserved4 (4 bytes): </b>An unsigned 32-bit
integer. This field is used for padding and MUST be ignored on receipt. It can
be any value.</p><p><b>Reserved5 (4 bytes): </b>An unsigned 32-bit
integer. This field is used for padding and MUST be ignored on receipt. It can
be any value.</p><p><b>Reserved6 (4 bytes): </b>An unsigned 32-bit
integer. This field is used for padding and MUST be ignored on receipt. It can
be any value.</p><p><b>Reserved7 (4 bytes): </b>An unsigned 32-bit
integer. This field is used for padding and MUST be ignored on receipt. It can
be any value.</p><p><b>VarData (16 bytes): </b>Contains the
LINEDIALPARAMS packet that specifies a collection of dialing-related fields. </p></div>