2.2.4.1.3.67 SetCallQualityOfService
The SetCallQualityOfService packet is transmitted from a TAPI client to a TAPI server in a remote procedure call. Sending this packet MUST allow a change to 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.
|
|
|
|
|
|
|
|
|
|
1 |
|
|
|
|
|
|
|
|
|
2 |
|
|
|
|
|
|
|
|
|
3 |
|
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Req_Func |
|||||||||||||||||||||||||||||||
Reserved1 |
|||||||||||||||||||||||||||||||
dwRequestID |
|||||||||||||||||||||||||||||||
hCall |
|||||||||||||||||||||||||||||||
lpSendingFlowspec |
|||||||||||||||||||||||||||||||
dwSendingFlowspecSize |
|||||||||||||||||||||||||||||||
lpReceivingFlowspec |
|||||||||||||||||||||||||||||||
dwReceivingFlowspecSize |
|||||||||||||||||||||||||||||||
Reserved2 |
|||||||||||||||||||||||||||||||
Reserved3 |
|||||||||||||||||||||||||||||||
Reserved4 |
|||||||||||||||||||||||||||||||
Reserved5 |
|||||||||||||||||||||||||||||||
Reserved6 |
|||||||||||||||||||||||||||||||
Reserved7 |
|||||||||||||||||||||||||||||||
Reserved8 |
|||||||||||||||||||||||||||||||
VarData (32 bytes) |
|||||||||||||||||||||||||||||||
... |
|||||||||||||||||||||||||||||||
... |
Req_Func (4 bytes): An unsigned 32-bit integer. The identifier of the function that will be invoked on the remote server. This value MUST be set to 74.
-
Return Values
-
On completion of ClientRequest, this field MUST contain 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 LINEERR_Constants value indicates synchronous failure.
-
Returns a positive request identifier if the asynchronous operation starts; otherwise, the function MUST return one of these negative error values:
-
Name
Value
LINEERR_INVALCALLHANDLE
0x80000018
LINEERR_INVALCALLSTATE
0x8000001C
LINEERR_INVALPARAM
0x80000032
LINEERR_INVALPOINTER
0x80000035
LINEERR_INVALRATE
0x80000037
LINEERR_NOMEM
0x80000044
LINEERR_NOTOWNER
0x80000046
LINEERR_OPERATIONUNAVAIL
0x80000049
LINEERR_OPERATIONFAILED
0x80000048
LINEERR_RATEUNAVAIL
0x8000004A
LINEERR_RESOURCEUNAVAIL
0x8000004B
LINEERR_UNINITIALIZED
0x80000050
Reserved1 (4 bytes): An unsigned 32-bit integer. MUST be set to zero when sent and MUST be ignored on receipt.
dwRequestID (4 bytes): An unsigned 32-bit integer. The identifier of the asynchronous request.
-
Value
Meaning
0x00000000
The server MUST generate a unique positive request ID to return as the Ack_ReturnValue.
0x00000001 — 0x7FFFFFFF
The server MUST use this value instead of generating a unique positive request ID.
hCall (4 bytes): An HCALL. The handle to the call. One way of obtaining a valid hCall is by sending the MakeCall packet. Also a valid hCall can be obtained from LINE_CALLSTATE packet sent by the remote server. The application MUST have OWNER privilege.
lpSendingFlowspec (4 bytes): An unsigned 32-bit integer. The offset, in bytes, in the VarData field of a WinSock2 FLOWSPEC packet that is followed by provider-specific data.
dwSendingFlowspecSize (4 bytes): An unsigned 32-bit integer. The total size, in bytes, of the FLOWSPEC packet and accompanying provider-specific data. This is equivalent to what would have been stored in SendingFlowspec in a QoS packet.
lpReceivingFlowspec (4 bytes): An unsigned 32-bit integer. The offset, in bytes, in the VarData field of a WinSock2 FLOWSPEC packet, followed by provider-specific data.
dwReceivingFlowspecSize (4 bytes): An unsigned 32-bit integer. The total size, in bytes, of the FLOWSPEC and accompanying provider-specific data. This is equivalent to what would have been stored in ReceivingFlowspec in a QoS packet.
Reserved2 (4 bytes): An unsigned 32-bit integer. This field is used for padding and MUST be ignored on receipt. It can be any value.
Reserved3 (4 bytes): An unsigned 32-bit integer. This field is used for padding and MUST be ignored on receipt. It can be any value.
Reserved4 (4 bytes): An unsigned 32-bit integer. This field is used for padding and MUST be ignored on receipt. It can be any value.
Reserved5 (4 bytes): An unsigned 32-bit integer. This field is used for padding and MUST be ignored on receipt. It can be any value.
Reserved6 (4 bytes): An unsigned 32-bit integer. This field is used for padding and MUST be ignored on receipt. It can be any value.
Reserved7 (4 bytes): An unsigned 32-bit integer. This field is used for padding and MUST be ignored on receipt. It can be any value.
Reserved8 (4 bytes): An unsigned 32-bit integer. This field is used for padding and MUST be ignored on receipt. It can be any value.
VarData (32 bytes): MUST Contain a WinSock2 FLOWSPEC packet that is followed by provider-specific data that is indicated in the lpSendingFlowspec field; and a WinSock2 FLOWSPEC packet that is followed by the provider-specific data that is indicated by the lpReceivingFlowspec field.
-
The contents of this field are DWORD-aligned.