2.2.4.1.3.70 SetDevConfig
The SetDevConfig packet is transmitted from a TAPI client to a TAPI server in a remote procedure call. Sending this packet MUST restore the configuration of a device that is associated one-to-one with the line device.
|
|
|
|
|
|
|
|
|
|
1 |
|
|
|
|
|
|
|
|
|
2 |
|
|
|
|
|
|
|
|
|
3 |
|
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Req_Func |
|||||||||||||||||||||||||||||||
|
Reserved1 |
|||||||||||||||||||||||||||||||
|
dwDeviceID |
|||||||||||||||||||||||||||||||
|
lpDeviceConfig |
|||||||||||||||||||||||||||||||
|
dwSize |
|||||||||||||||||||||||||||||||
|
lpszDeviceClass |
|||||||||||||||||||||||||||||||
|
Reserved2 |
|||||||||||||||||||||||||||||||
|
Reserved3 |
|||||||||||||||||||||||||||||||
|
Reserved4 |
|||||||||||||||||||||||||||||||
|
Reserved5 |
|||||||||||||||||||||||||||||||
|
Reserved6 |
|||||||||||||||||||||||||||||||
|
Reserved7 |
|||||||||||||||||||||||||||||||
|
Reserved8 |
|||||||||||||||||||||||||||||||
|
Reserved9 |
|||||||||||||||||||||||||||||||
|
Reserved10 |
|||||||||||||||||||||||||||||||
|
VarData (variable) |
|||||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
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 77.
-
Return Values
-
On completion of ClientRequest, this field MUST contain the result of the encapsulated telephony request. A value of 0 indicates success, and a LINEERR_Constants value indicates failure. The remote server MUST complete this call synchronously.
-
Returns zero if the function succeeds or an error number if an error occurs. Common return values are:
-
Name
Value
LINEERR_INVALDEVICECLASS
0x80000023
LINEERR_NOMEM
0x80000044
LINEERR_INVALPOINTER
0x80000035
LINEERR_OPERATIONUNAVAIL
0x80000049
LINEERR_INVALPARAM
0x80000032
LINEERR_OPERATIONFAILED
0x80000048
LINEERR_INVALLINESTATE
0x8000002C
LINEERR_RESOURCEUNAVAIL
0x8000004B
LINEERR_NODRIVER
0x80000043
Reserved1 (4 bytes): An unsigned 32-bit integer. MUST be set to zero when sent and MUST be ignored on receipt.
dwDeviceID (4 bytes): An unsigned 32-bit integer. The line device to be configured. A valid value of dwDeviceID is in the range 0 to dwNumDevs –1. The client obtains dwNumDevs by sending a Initialize packet to the remote server.
lpDeviceConfig (4 bytes): An unsigned 32-bit integer. The offset, in bytes, in the VarData field of the device configuration data structure VARSTRING that was returned by the GetDevConfig packet.
dwSize (4 bytes): An unsigned 32-bit integer. The number of bytes in the packet that is pointed to by lpDeviceConfig.
lpszDeviceClass (4 bytes): An unsigned 32-bit integer. The offset, in bytes, in the VarData field of a null-terminated Unicode string that specifies the device class of the device whose configuration will be restored.
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.
Reserved9 (4 bytes): An unsigned 32-bit integer. This field is used for padding and MUST be ignored on receipt. It can be any value.
Reserved10 (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 (variable): MUST contain a configuration data packet VARSTRING that is indicated by the lpDeviceConfig field and a null-terminated Unicode string that is indicated by the lpszDeviceClass field in the original request. This field is not present in the response.
-
The contents of this field are DWORD-aligned.