2.2.4.1.3.43 MakeCall
The MakeCall packet is transmitted from a TAPI client to a TAPI server in a remote procedure call. Sending this packet places a call on the specified line to the specified destination address. Optionally, call parameters can be specified if anything but default call setup parameters are requested.
|
|
|
|
|
|
|
|
|
|
1 |
|
|
|
|
|
|
|
|
|
2 |
|
|
|
|
|
|
|
|
|
3 |
|
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Req_Func |
|||||||||||||||||||||||||||||||
Reserved1 |
|||||||||||||||||||||||||||||||
dwRequestID |
|||||||||||||||||||||||||||||||
lpContext |
|||||||||||||||||||||||||||||||
hLine |
|||||||||||||||||||||||||||||||
lphCallContext |
|||||||||||||||||||||||||||||||
lpszDestAddress |
|||||||||||||||||||||||||||||||
dwCountryCode |
|||||||||||||||||||||||||||||||
lpCallParams |
|||||||||||||||||||||||||||||||
dwCallParamsCodePage |
|||||||||||||||||||||||||||||||
Reserved2 |
|||||||||||||||||||||||||||||||
Reserved3 |
|||||||||||||||||||||||||||||||
Reserved4 |
|||||||||||||||||||||||||||||||
Reserved5 |
|||||||||||||||||||||||||||||||
Reserved6 |
|||||||||||||||||||||||||||||||
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 48.
-
Return Values
-
On completion of ClientRequest, this field contains 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 function will be completed asynchronously or a negative error number if an error occurs. The dwParam2 parameter of the corresponding LINE_REPLY packet is zero if the function succeeds, or it is a negative error number if an error occurs. If the client specified a nonzero value in the dwRequestID field of the packet, the same value MUST be used for the returned positive request identifier. Common return values are as follows:
-
Name
Value
LINEERR_ADDRESSBLOCKED
0x80000053
LINEERR_INVALLINESTATE
0x8000002C
LINEERR_BEARERMODEUNAVAIL
0x80000003
LINEERR_INVALRATE
0x80000037
LINEERR_CALLUNAVAIL
0x80000005
LINEERR_INVALLINEHANDLE
0x8000002B
LINEERR_DIALBILLING
0x80000008
LINEERR_INVALADDRESS
0x80000010
LINEERR_DIALQUIET
0x8000000B
LINEERR_INVALADDRESSID
0x80000011
LINEERR_DIALDIALTONE
0x80000009
LINEERR_INVALCALLPARAMS
0x80000019
LINEERR_DIALPROMPT
0x8000000A
LINEERR_NOMEM
0x80000044
LINEERR_INUSE
0x8000000F
LINEERR_OPERATIONUNAVAIL
0x80000049
LINEERR_INVALADDRESSMODE
0x80000012
LINEERR_OPERATIONFAILED
0x80000048
LINEERR_INVALBEARERMODE
0x80000016
LINEERR_RESOURCEUNAVAIL
0x8000004B
LINEERR_INVALCOUNTRYCODE
0x80000022
LINEERR_RATEUNAVAIL
0x8000004A
LINEERR_INVALMEDIAMODE
0x8000002F
LINEERR_USERUSERINFOTOOBIG
0x80000051
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.
lpContext (4 bytes): An unsigned 32-bit integer. The opaque, client-specified value that is used by the client upon request completion; MUST be returned by the server in the request completion packet.
hLine (4 bytes): An HLINE. The handle to the open line on which the new call is to originate. This field MUST have been obtained by sending the Open packet.
lphCallContext (4 bytes): An unsigned 32-bit integer. The opaque, client-specified value that is used by the client upon request completion; MUST be returned by the server in the request completion packet.
lpszDestAddress (4 bytes): An unsigned 32-bit integer. The offset, in bytes, in the VarData field of a null-terminated Unicode string that specifies the destination address. If this field is -1 (0xFFFFFFFF), no destination address is sent.
dwCountryCode (4 bytes): An unsigned 32-bit integer. The country code of the called party. f a value of 0 is specified, an implementation specific default MUST be used.
lpCallParams (4 bytes): An unsigned 32-bit integer. The offset, in bytes, in the VarData field of a LINECALLPARAMS packet that contains call parameters. If this field is -1 (0xFFFFFFFF), no call parameters are sent.
dwCallParamsCodePage (4 bytes): An unsigned 32-bit integer. This MUST be set to TAPI_NO_DATA (0xFFFFFFFF).
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.
VarData (variable): Contains a null-terminated Unicode string that is indicated by the lpszDestAddress field and a LINECALLPARAMS packet that is indicated by the lpCallParams field.