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
| Requirement | Value |
|---|---|
| Target Platform | Windows |
| Header | tapi.h |
| Library | Tapi32.lib |
| DLL | Tapi32.dll |