lineSetCallQualityOfService function (tapi.h)

The lineSetCallQualityOfService function allows the application to attempt to change the quality of service parameters (reserved capacity and performance guarantees) for an existing call. Except for basic parameter validation, this is a straight pass-through to a service provider.

Syntax

LONG lineSetCallQualityOfService(
  HCALL  hCall,
  LPVOID lpSendingFlowspec,
  DWORD  dwSendingFlowspecSize,
  LPVOID lpReceivingFlowspec,
  DWORD  dwReceivingFlowspecSize
);

Parameters

hCall

Handle to the call. The application must have OWNER privilege.

lpSendingFlowspec

Pointer to memory containing a FLOWSPEC structure followed by provider-specific data. The provider-specific portion following the FLOWSPEC structure must not contain pointers to other blocks of memory in the application process, because TAPI will not know how to marshal the data pointed to by the private pointer(s) and convey it through interprocess communication to the service provider.

dwSendingFlowspecSize

Total size of the FLOWSPEC structure and accompanying provider-specific data, in bytes. This is equivalent to what would have been stored in SendingFlowspec in a QOS structure.

lpReceivingFlowspec

Pointer to memory containing a FLOWSPEC structure followed by provider-specific data. The provider-specific portion following the FLOWSPEC structure must not contain pointers to other blocks of memory in the application process, because TAPI will not know how to marshal the data pointed to by the private pointer(s) and convey it through interprocess communication to the service provider.

dwReceivingFlowspecSize

Total size of the FLOWSPEC and accompanying provider-specific data, in bytes. This is equivalent to what would have been stored in ReceivingFlowspec in a QOS structure.

Return value

Returns a positive request identifier if the asynchronous operation starts; otherwise, the function returns one of these negative error values:

LINEERR_INVALCALLHANDLE, LINEERR_INVALCALLSTATE, LINEERR_INVALPARAM, LINEERR_INVALPOINTER, LINEERR_INVALRATE, LINEERR_NOMEM, LINEERR_NOTOWNER, LINEERR_OPERATIONUNAVAIL, LINEERR_OPERATIONFAILED, LINEERR_RATEUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED.

Requirements

See also

FLOWSPEC

QOS

Supplementary Line Service Functions

TAPI 2.2 Reference Overview