lineSetCallQualityOfService

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.

LONG WINAPI 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 WinSock2 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

The total size in bytes of the FLOWSPEC structure and accompanying provider-specific data, equivalent to what would have been stored in SendingFlowspec.len in a WinSock2 QOS structure.

lpReceivingFlowspec

Pointer to memory containing a WinSock2 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

The total size in bytes of the FLOWSPEC and accompanying provider-specific data, equivalent to what would have been stored in ReceivingFlowspec.len in a WinSock2 QOS structure.

Return Values

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

  Windows NT/2000: Requires Windows NT 4.0 SP3 or later.
  Windows 95/98: Requires Windows 95 or later.
  Version: Requires TAPI 2.0 or later.
  Header: Declared in Tapi.h.
  Library: Use Tapi32.lib.

See Also

TAPI 2.2 Reference Overview, Supplementary Line Service Functions