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 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,
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.