The lineMakeCall function places a call on the specified line to the specified destination address. Optionally, you can specify call parameters if anything but default call setup parameters are requested.
FUNCTION DETAILS:
LONG lineMakeCall(HLINE hLine,
LPHCALL lphCall,
LPCSTR lpszDestAddress,
DWORD dwCountryCode,
LPLINECALLPARAMS const lpCallParams
);
typedef struct LineParams {
DWORD FeaturePriority;
PARAMETERS:
hLine
A handle to the open line device on which a call is to be originated.
lphCall
A pointer to an HCALL handle. The handle is only valid after the application receives LINE_REPLY
message that indicatesthat the lineMakeCall function successfully completed. Use this handle to identify the call when you invoke other telephony operations on the call. The application initially acts as the sole owner of this call. This handle registers as void if the reply message returns an error (synchronously or asynchronously).
lpszDestAddress
A pointer to the destination address. This parameter follows the standard dialable number format. This pointer can be NULL for non-dialed addresses or when all dialing is performed by using lineDial. In the latter case, lineMakeCall allocates an available call appearance that would typically remain in the dial tone state until dialing begins.
dwCountryCode The country code of the called party. If a value of 0 is specified, the implementation uses a default.
lpCallParams
The dwNoAnswerTimeout attribute of the lpCallParams field is checked and if specified as non-zero, automatically disconnects a call if not answered after the specified time.
Create a Persistent Call:
The TAPI lineMakeCall function is used to create persistent call.. The relevant data is provided in
LINECALLPARAMS structure pointed to by the lpLineCallParams parameter. Cisco TSP ignores all other lineMakeCall parameter for a persistent call.
For a persistent call, the LINECALLPARAMS contains the following data:
- DevSpecific part refering to Cisco_CallParamsDevSpecific structure where DevSpecificFlags is set to Cisco_CALLPARAMS_DEVSPECIFICFLAGS_PERSISTENT CALL (0x00000002)
- CallingPartyID set to a directory number that appears as a remote destination CallerID directory number
- DisplayableAddress set to a name that appears as the remote destination CallerIDName.
Create an Announcement Call:
The TAPI lineMakeCall function is used to create announcement call. The relevant data is provided in LINECALLPARAMS structure pointed to by the lpLineCallParams parameter. CiscoTSP ignores all other lineMakeCall parameters in the case of announcement call.
In the case of an announcement call, the following data is provided in the LINECALLPARAMS:
- DevSpecific part refers to Cisco_CallParamsDevSpecific structure where the DevSpecificFlags is set to Cisco_CALLPARAMS_DEVSPECIFICFLAGS_ANNOUNCEMENTCALL
- CallData is set to a media content identifier (announcementID)
Feature priority introduces LineMakeCall as part of DevSpecific data. Currently the following structure is supported in DevSpecific data for LineMakeCall:
typedef struct LineParams {
DWORD FeaturePriority;
} LINE_PARAMS;
Comments
0 comments
Please sign in to leave a comment.