Table Of Contents
Cisco Device Specific Extensions
Cisco Line Device Specific Extensions
LINEDEVCAPS Device Specific Extensions
LINECALLINFO Device Specific Extensions
LINEDEVSTATUS Device Specific Extensions
Redirect Reset Original Called ID
Setting RTP Parameters for Call
Redirect Set Original Called ID
Cisco Phone Device Specific Extensions
CCiscoPhoneDevSpecificDataPassThrough
CCiscoPhoneDevSpecificDeacquire
CCiscoPhoneDevSpecificGetRTPSnapshot
LINECALLINFO_DEVSPECIFICDATA Events
Redirect Set Original Called (TxToVM)
Make a Call Through Translation Pattern
Blind Transfer Through Translation Pattern
Forced Authorization and Client Matter Code Scenarios
Manual Call to a Destination that Requires a FAC
Manual Call to a Destination that Requires both FAC and CMC
lineMakeCall to a Destination that Requires a FAC
lineMakeCall to a Destination that Requires Both FAC and CMC
Timeout Waiting for FAC or Invalid FAC entered
In-Dialog Refer - Referrer in Cisco Unified CallManager Cluster
In-Dialog Refer Where ReferToTarget Redirects the Call in Offering State
In-Dialog Refer Where Refer Fails / Refer to Target is Busy
Invite with Replace for Confirmed Dialog
Refer with Replace for All in Cluster
Refer with Replace for All in Cluster, Replace Dialog Belongs to Another Station
Media Terminate by Application (open secure CTI port or RP)
Media Terminate by TSP Wave Driver (open secure CTI port)
Cisco Device Specific Extensions
This chapter describes the Cisco device-specific TAPI extensions. It describes how to invoke the Cisco device-specific TAPI extensions with the lineDevSpecific function. It also describes a set of classes that can be used when calling phoneDevSpecific.
Cisco Line Device Specific Extensions
CiscoLineDevSpecific, the CCiscoPhoneDevSpecific class, represents the parent class.
Table 4-1 lists the subclasses of Cisco Line Device Specific Extensions.
Structures
This section describes device-specific extensions that have been made to the TAPI structures that the Cisco Unified TSP supports.
LINEDEVCAPS Device Specific Extensions
Description
The LineDevCaps_DevSpecificData structure describes the device-specific extensions that the Cisco Unified TSP has made to the LINEDEVCAPS structure.
Detail
A
typedef struct LineDevCaps_DevSpecificData{DWORD m_DevSpecificFlags;}LINEDEVCAPS_DEV_SPECIFIC_DATA;
Note
This extension is only available if extension version 3.0 (0x00030000) or higher is negotiated.
B
typedef struct LocaleInfo{DWORD Locale; //This will have the locale info of the deviceDWORD PartitionOffset;DWORD PartitionSize; //This will have the partition info of the line.} LOCALE_INFO;
Note
C
typedef struct PartitionInfo{DWORD PartitionOffset;DWORD PartitionSize; //This will have the partition info of the line.} PARTITION_INFO;
Note
Parameters
DWORD m_DevSpecificFlags
A bit array that identifies device specific properties for the line. The bits definition follows:
LINEDEVCAPSDEVSPECIFIC_PARKDN (0x00000001)—Indicates whether this line is a Call Park DN.
Note
DWORD Locale
This identifies the locale information for the device. The typical values could be:
enum{ENGLISH_UNITED_STATES = 1,FRENCH_FRANCE = 2,GERMAN_GERMANY = 3,RUSSIAN_RUSSIA = 5,SPANISH_SPAIN = 6,ITALIAN_ITALY = 7,DUTCH_NETHERLAND = 8,NORWEGIAN_NORWAY = 9,PORTUGUESE_PORTUGAL = 10,SWEDISH_SWEDEN = 11,DANISH_DENMARK = 12,JAPANESE_JAPAN = 13,HUNGARIAN_HUNGARY = 14,POLISH_POLAND = 15,GREEK_GREECE = 16,TRADITIONAL_CHINESE_CHINA = 19,SIMPLIFIED_CHINESE_CHINA = 20,KOREAN_KOREA = 21}LINECALLINFO Device Specific Extensions
Description
The TSP_Unicode_Party_names structure and SRTP info structure describes the device specific extensions that have been made to the LINECALLINFO structure by the Cisco Unified TSP. DSCPValueForAudioCalls will contain the DSCP value sent by CTI in the StartTransmissionEvent.
ExtendedCallInfo structure will have extra call information. For this release ExtendedCallReason field will be part of the ExtendedCallInfo structure.
Detail
DWORD TapiCallerPartyUnicodeNameOffset;DWORD TapiCallerPartyUnicodeNameSize;DWORD TapiCallerPartyLocale;DWORD TapiCalledPartyUnicodeNameOffset;DWORD TapiCalledPartyUnicodeNameSize;DWORD TapiCalledPartyLocale;DWORD TapiConnectedPartyUnicodeNameOffset;DWORD TapiConnectedPartyUnicodeNameSize;DWORD TapiConnectedPartyLocale;DWORD TapiRedirectionPartyUnicodeNameOffset;DWORD TapiRedirectionPartyUnicodeNameSize;DWORD TapiRedirectionPartyLocale;DWORD TapiRedirectingPartyUnicodeNameOffset;DWORD TapiRedirectingPartyUnicodeNameSize;DWORD TapiRedirectingPartyLocale;DWORD SRTPKeyInfoStructureOffset; // offset from base of LINECALLINFODWORD SRTPKeyInfoStructureSize; // includes variable length data total sizeDWORD SRTPKeyInfoStructureElementCount;DWORD SRTPKeyInfoStructureElementFixedSize;DWORD DSCPValueInformationOffset;DWORD DSCPValueInformationSize;DWORD DSCPValueInformationElementCount;DWORD DSCPValueInformationElementFixedSize;DWORD PartitionInformationOffset; // offset from base of LINECALLINFODWORD PartitionInformationSize; // includes variable length data total sizeDWORD PartitionInformationElementCount;DWORD PartitionInformationElementFixedSize;DWORD ExtendedCallInfoOffset;DWORD ExtendedCallInfoSize;DWORD ExtendedCallInfoElementCount;DWORD ExtendedCallInfoElementSize;typedef struct SRTPKeyInfoStructure{SRTPKeyInformation TransmissionSRTPInfo;SRTPKeyInformation ReceptionSRTPInfo;} SRTPKeyInfoStructure;typedef struct SRTPKeyInformation{DWORD IsSRTPDataAvailable;DWORD SecureMediaIndicator; // CiscoSecurityIndicatorDWORD MasterKeyOffset;DWORD MasterKeySize;DWORD MasterSaltOffset;DWORD MasterSaltSize;DWORD AlgorithmID; // CiscoSRTPAlgorithmIDsDWORD IsMKIPresent;DWORD KeyDerivationRate;} SRTPKeyInformation;enum CiscoSRTPAlgorithmIDs{SRTP_NO_ENCRYPTION=0,SRTP_AES_128_COUNTER=1};enum CiscoSecurityIndicator{SRTP_MEDIA_ENCRYPT_KEYS_AVAILABLE,SRTP_MEDIA_ENCRYPT_USER_NOT_AUTH,SRTP_MEDIA_ENCRYPT_KEYS_UNAVAILABLE,SRTP_MEDIA_NOT_ENCRYPTED};If isSRTPInfoavailable is set to false, the rest of the information from SRTPKeyInformation should be ignored.
If MasterKeySize or MasterSlatSize is set to 0, then the corresponding MasterKeyOffset or MasterSaltOffset should be ignored.
typedef struct DSCPValueInformation{DWORD DSCPValueForAudioCalls;}typedef struct PartitionInformation{DWORD CallerIDPartitionOffset;DWORD CallerIDPartitionSize;DWORD CalledIDPartitionOffset;DWORD CalledIDPartitionSize;DWORD ConnecetedIDPartitionOffset;DWORD ConnecetedIDPartitionSize;DWORD RedirectionIDPartitionOffset;DWORD RedirectionIDPartitionSize;DWORD RedirectingIDPartitionOffset;DWORD RedirectingIDPartitionSize;} PartitionInformation;Struct ExtendedCallInfo{DWORD ExtendedCallReason ;DWORD CallerIDURLOffset; // CallPartySipURLInfoDWORD CallerIDURISize;DWORD CalledIDURLOffset; // CallPartySipURLInfoDWORD CalledIDURISize;DWORD ConnectedIDURIOffset; // CallPartySipURLInfoDWORD ConnectedIDURISize;DWORD RedirectionIDURIOffset; // CallPartySipURLInfoDWORD RedirectionIDURISize;DWORD RedirectingIDURIOffset; // CallPartySipURLInfoDWORD RedirectingIDURISize;}Struct CallPartySipURLInfo{DWORD dwUserOffset; //sip user stringDWORD dwUserSize;DWORD dwHostOffset; //host name stringDWORD dwHostSize;DWORD dwPort; // integer port numberDWORD dwTransportType; // SIP_TRANS_TYPEDWORD dwURLType; // SIP_URL_TYPE}enum {CTI_SIP_TRANSPORT_TCP=1,CTI_SIP_TRANSPORT_UDP,CTI_SIP_TRANSPORT_TLS} SIP_TRANS_TYPE;enum {CTI_NO_URL = 0,CTI_SIP_URL,CTI_TEL_URL} SIP_URL_TYPE;Parameters
Note
Also, whenever there is a change in the partition information, a LINEDEVSPECIFIC event will be fired indicating which exact field in the devSpecific portion of the LINECALLINFO has changed as shown below. This event if fired only if the application has negotiated 7.0 extension version or higher.
LINEDEVSPECIFIC{hDevice = hcall //call handle for which the info has changed.dwParam1 = SLDSMT_LINECALLINFO_DEVSPECIFICDATA //indicates DevSpecific portion's changeddwParam2 = SLDST_SRTP_INFO|SLDST_QOS_INFO|SLDST_PARTITION_INFO|SLDST_EXTENDED_CALL_INFOdwParam3 = ...dwParam3 will be security indicator if dwParam2 has bit set for SLDST_SRTP_INFO}SLDST_SRTP_INFO = 0x00000001SLDST_QOS_INFO = 0x00000002SLDST_PARTITION_INFO = 0x00000004SLDST_EXTENDED_CALL_INFO = 0x00000008LINEDEVSTATUS Device Specific Extensions
Description
The LINEDEVSTATUS_DEV_SPECIFIC_DATA structure describes the device specific extensions that have been made to the LINEDEVSTATUS structure by the Cisco Unified TSP.
Detail
typedef struct devSpecific_SupportedEncoding{DWORD dwSupportedEncoding;LPCSTR lpszAlternateScript;}LINEDEVSTATUS_DEV_SPECIFIC_DATA;
Note
Parameters
DWORD dwSupportEncoding
This indicates the Support Encoding for the Unicode Party names being sent in device specfic extension of the LINECALLINFO structure.
The typical values could be:
enum {UnknownEncoding = 0, // Unknown encodingNotApplicableEncoding = 1, // Encoding not applicable to this deviceAsciiEncoding = 2, // ASCII encodingUcs2UnicodeEncoding = 3 // UCS-2 Unicode encoding}LPCSTR lpszAlternateScript
This parameter specifies the alternate script supported by the device. An empty string indicates the device does not support or is not configured with an alternate script.
The only supported script in this release is "Kanji" for the Japanese locale.
CCiscoLineDevSpecific
CCiscoLineDevSpecific|+-- CCiscoLineDevSpecificMsgWaiting|+-- CCiscoLineDevSpecificMsgWaitingDirn|+-- CCiscoLineDevSpecificUserControlRTPStream|+--CciscoLineDevSpecificSetStatusMsgs|+--CCiscoLineDevSpecificRedirectResetOrigCalled|+--CCiscoLineDevSpecificPortRegistrationPerCall|+--CciscoLineDevSpecificSetRTPParamsForCall|+--CCiscoLineDevSpecificRedirectSetOrigCalled|+--CCiscoLineDevSpecificJoin|+--CciscoLineDevSpecificUserSetSRTPAlgorithmID|+--CCiscoLineDevSpecificAcquire|+--CciscoLineDevSpecificDeacquire|+-- CciscoLineDevSpecificSendLineOpenDescription
This section provides information on how to perform Cisco Unified TAPI specific functions with the CCiscoLineDevSpecific class, which represents the parent class to all the following classes. It comprises a virtual class and is provided here for informational purposes.
Header File
The file CiscoLineDevSpecific.h contains the constant, structure, and class definition for the Cisco line device-specific classes.
Class Detail
class CCiscoLineDevSpecific{public:CCicsoLineDevSpecific(DWORD msgType);virtual ~CCiscoLineDevSpecific();DWORD GetMsgType(void) const {return m_MsgType;}void* lpParams() {return &m_MsgType;}virtual DWORD dwSize() = 0;private:DWORD m_MsgType;};Functions
lpParms()
Function can be used to obtain the pointer to the parameter block.
dwSize()
Function will give the size of the parameter block area.
Parameter
m_MsgType
Specifies the type of message.
Subclasses
Each subclass of CCiscoLineDevSpecific has a different value assigned to the parameter m_MsgType. If you are using C instead of C++, this is the first parameter in the structure.
Enumeration
The CiscoLineDevSpecificType enumeration provides valid message identifiers.
enum CiscoLineDevSpecificType {SLDST_MSG_WAITING = 1,SLDST_MSG_WAITING_DIRN,SLDST_USER_CRTL_OF_RTP_STREAM,SLDST_SET_STATUS_MESSAGES,SLDST_NUM_TYPE,SLDST_SWAP_HOLD_SETUP_TRANSFER, // Not Supported in Cisco TSP 3.4 and BeyondSLDST_REDIRECT_RESET_ORIG_CALLED,SLDST_USER_RECEIVE_RTP_INFO,SLDST_USER_SET_RTP_INFO,SLDST_JOIN,SLDST_USER_SET_SRTP_ALGORITHM_ID,SLDST_SEND_LINE_OPEN,};Message Waiting
CCiscoLineDevSpecific|+-- CCiscoLineDevSpecificMsgWaitingDescription
The CCiscoLineDevSpecificMsgWaiting class turns the message waiting lamp on or off for the line that the hLine parameter specifies.
Note
Class Detail
class CCiscoLineDevSpecificMsgWaiting : public CCiscoLineDevSpecific{public:CCiscoLineDevSpecificMsgWaiting() : CCiscoLineDevSpecific(SLDST_MSG_WAITING){}virtual ~CCiscoLineDevSpecificMsgWaiting() {}virtual DWORD dwSize(void) const {return sizeof(*this)-4;}DWORD m_BlinkRate;};Parameters
DWORD m_MsgType
Equals SLDST_MSG_WAITING.
DWORD m_BlinkRate
Any supported PHONELAMPMODE_ constants that are specified in the phoneSetLamp() function.
Note
Message Waiting Dirn
CCiscoLineDevSpecific|+-- CCiscoLineDevSpecificMsgWaitingDirnDescription
The CCiscoLineDevSpecificMsgWaitingDirn class turns the message waiting lamp on or off for the line that a parameter specifies and is independent of the hLine parameter.
Note
Class Detail
class CCiscoLineDevSpecificMsgWaitingDirn : public CCiscoLineDevSpecific{public:CCiscoLineDevSpecificMsgWaitingDirn() : CCiscoLineDevSpecific(SLDST_MSG_WAITING_DIRN) {}virtual ~CCiscoLineDevSpecificMsgWaitingDirn() {}virtual DWORD dwSize(void) const {return sizeof(*this)-4;}DWORD m_BlinkRate;char m_Dirn[25];};Parameters
DWORD m_MsgType
Equals SLDST_MSG_WAITING_DIRN.
DWORD m_BlinkRate
As in the CCiscoLineDevSpecificMsgWaiting message.
Note
char m_Dirn[25]
The directory number for which the message waiting lamp should be set.
Audio Stream Control
CCiscoLineDevSpecific|+-- CCiscoLineDevSpecificUserControlRTPStreamDescription
The CCiscoLineDevSpecificUserControlRTPStream class controls the audio stream of a line. To use this class, the lineNegotiateExtVersion API must be called before opening the line. When lineNegotiateExtVersion is called, the highest bit must be set on both the dwExtLowVersion and dwExtHighVersion parameters. This causes the call to lineOpen to behave differently. The line does not actually open, but waits for a lineDevSpecific call to complete the open with more information. The CCiscoLineDevSpecificUserControlRTPStream class provides the extra information that is required.
Procedure
Step 1
Step 2
Step 3
Class Detail
class CCiscoLineDevSpecificUserControlRTPStream : public CCiscoLineDevSpecific{public:CCiscoLineDevSpecificUserControlRTPStream() : CCiscoLineDevSpecific(SLDST_USER_CRTL_OF_RTP_STREAM),m_ReceiveIP(-1),m_ReceivePort(-1),m_NumAffectedDevices(0){memset(m_AffectedDeviceID, 0, sizeof(m_AffectedDeviceID));}virtual ~CCiscoLineDevSpecificUserControlRTPStream() {}DWORD m_ReceiveIP; // UDP audio reception IPDWORD m_ReceivePort; // UDP audio reception portDWORD m_NumAffectedDevices;DWORD m_AffectedDeviceID[10];DWORD m_MediaCapCount;MEDIA_CAPS m_MediaCaps;virtual DWORD dwSize(void) const {return sizeof(*this)-4;}};Parameters
DWORD m_MsgType
Equals SLDST_USER_CRTL_OF_RTP_STREAM
DWORD m_ReceiveIP:
The RTP audio reception IP address in network byte order
DWORD m_ReceivePort:
The RTP audio reception port in network byte order
DWORD m_NumAffectedDevices:
The TSP returns this value. It contains the number of deviceIDs in the m_AffectedDeviceID array that are valid. Any device with multiple directory numbers that are assigned to it will have multiple TAPI lines, one per directory number.
DWORD m_AffectedDeviceID[10]:
The TSP returns this value. It contains the list of deviceIDs for any device that is affected by this call. Do not call lineDevSpecific for any other device in this list.
DWORD m_mediaCapCount
The number of codecs that are supported for this line.
MEDIA_CAPS m_MediaCaps -
A data structure with the following format:
typedef struct {
DWORD MediaPayload;
DWORD MaxFramesPerPacket;
DWORD G723BitRate;
} MEDIA_CAPS[MAX_MEDIA_CAPS_PER_DEVICE];
This data structure defines each codec that is supported on a line. The limit specifies 18. The following description shows each member in the MEDIA_CAPS data structure:
MediaPayload specifies an enumerated integer that contains one of the following values:
enum{Media_Payload_G711Alaw64k = 2,Media_Payload_G711Alaw56k = 3, // "restricted"Media_Payload_G711Ulaw64k = 4,Media_Payload_G711Ulaw56k = 5, // "restricted"Media_Payload_G722_64k = 6,Media_Payload_G722_56k = 7,Media_Payload_G722_48k = 8,Media_Payload_G7231 = 9,Media_Payload_G728 = 10,Media_Payload_G729 = 11,Media_Payload_G729AnnexA = 12,Media_Payload_G729AnnexB = 15,Media_Payload_G729AnnexAwAnnexB = 16,Media_Payload_GSM_Full_Rate = 18,Media_Payload_GSM_Half_Rate = 19,Media_Payload_GSM_Enhanced_Full_Rate = 20,Media_Payload_Wide_Band_256k = 25,Media_Payload_Data64 = 32,Media_Payload_Data56 = 33,Media_Payload_GSM = 80,Media_Payload_G726_32K = 82,Media_Payload_G726_24K = 83,Media_Payload_G726_16K = 84,// Media_Payload_G729_B = 85,// Media_Payload_G729_B_LOW_COMPLEXITY = 86,} Media_PayloadType;Read MaxFramesPerPacket as MaxPacketSize. It specifies a 16-bit integer that indicates the maximum desired RTP packet size in milliseconds. Typically, this value is set to 20.
G723BitRate specifies a 6-byte field that contains either the G.723.1 information bit rate or is ignored. The following list provides values for the G.723.1 field are values.
enum{Media_G723BRate_5_3 = 1, //5.3KbpsMedia_G723BRate_6_4 = 2 //6.4Kbps} Media_G723BitRate;Set Status Messages
CCiscoLineDevSpecific|+-- CCiscoLineDevSpecificSetStatusMsgsDescription
The CCiscoLineDevSpecificSetStatusMsgs class is used to turn on or off the status messages for the line specified by the hLine parameter. The Cisco Unified TSP supports the following flags:
•
•
Note
Class Detail
class CCiscoLineDevSpecificSetStatusMsgs : public CCiscoLineDevSpecific{public:CCiscoLineDevSpecificSetStatusMsgs() :CCiscoLineDevSpecific(SLDST_SET_STATUS_MESSAGES) {}virtual ~CCiscoLineDevSpecificSetStatusMsgs() {}DWORD m_DevSpecificStatusMsgsFlag;virtual DWORD dwSize(void) const {return sizeof(*this)-4;}};Parameters
DWORD m_MsgType
Equals SLDST_SET_STATUS_MESSAGES.
DWORD m_DevSpecificStatusMsgsFlag
Identifies which status changes cause a LINE_DEVSPECIFIC message to be sent to the application.
The supported values are as follows:
#define DEVSPECIFIC_MEDIA_STREAM 0x00000001#define DEVSPECIFIC_CALL_TONE_CHANGED 0x00000002Swap-Hold/SetupTransfer
Note
The CCiscoLineDevSpecificSwapHoldSetupTransfer class was used to perform a SetupTransfer between a call that is in CONNECTED state and a call that is in the ONHOLD state. This function would change the state of the connected call to ONHOLDPENDTRANSFER state and the ONHOLD call to CONNECTED state. This would then allow a CompleteTransfer to be performed on the two calls. In Cisco Unified TSP 4.0 and beyond, the TSP allows applications to use lineCompleteTransfer() to transfer the calls without having to use the CCiscoLineDevSpecificSwapHoldSetupTransfer function. Therefore, this function returns LINEERR_OPERATIONUNAVAIL in Cisco Unified TSP 4.0 and beyond.
CCiscoLineDevSpecific|+-- CCiscoLineDevSpecificSwapHoldSetupTransferDescription
The CCiscoLineDevSpecificSwapHoldSetupTransfer class performs a setupTransfer between a call that is in CONNECTED state and a call that in ONHOLD state. This function will change the state of the connected call to ONHOLDPENDTRANSFER state and the ONHOLD call to CONNECTED state. This will then allow a completeTransfer to be performed on the two calls.
Note
Class Details
class CCiscoLineDevSpecificSwapHoldSetupTransfer : public CCiscoLineDevSpecific{public:CCiscoLineDevSpecificSwapHoldSetupTransfer() : CCiscoLineDevSpecific(SLDST_SWAP_HOLD_SETUP_TRANSFER) {}virtual ~CCiscoLineDevSpecificSwapHoldSetupTransfer() {}DWORD heldCallID;virtual DWORD dwSize(void) const {return sizeof(*this)-4;} // subtract out the virtual function table pointer};Parameters
DWORD m_MsgType
Equals SLDST_SWAP_HOLD_SETUP_TRANSFER.
DWORD heldCallID
Equals the callid of the held call that is returned in dwCallID of LPLINECALLINFO.
HCALL hCall (in lineDevSpecific parameter list)
Equals the handle of the connected call.
Redirect Reset Original Called ID
CCiscoLineDevSpecific|+-- CCiscoLineDevSpecificRedirectResetOrigCalledDescription
The CCiscoLineDevSpecificRedirectResetOrigCalled class redirects a call to another party while resetting the original called ID of the call to the destination of the redirect.
Note
Class Details
class CCiscoLineDevSpecificRedirectResetOrigCalled: public CCiscoLineDevSpecific{public:CCiscoLineDevSpecificRedirectResetOrigCalled: CCiscoLineDevSpecific(SLDST_REDIRECT_RESET_ORIG_CALLED) {}virtual ~CCiscoLineDevSpecificRedirectResetOrigCalled{}char m_DestDirn[25]; //redirect destination addressvirtual DWORD dwSize(void) const {return sizeof(*this)-4;} // subtract out the virtual function table pointer};Parameters
DWORD m_MsgType
Equals SLDST_REDIRECT_RESET_ORIG_CALLED.
DWORD m_DestDirn
Equals the destination address where the call needs to be redirected.
HCALL hCall (In lineDevSpecific parameter list)
Equals the handle of the connected call.
Port Registration per Call
CCiscoLineDevSpecific|+-- CCiscoLineDevSpecificPortRegistrationPerCallDescription
The CCiscoLineDevSpecificPortRegistrationPerCall class registers the CTI Port for the RTP parameters on a per call basis. With this request, the application receives the new lineDevSpecific event requesting that it needs to set the RTP parameters for the call.
To use this class, the lineNegotiateExtVersion API must be called before opening the line. When calling lineNegotiateExtVersion, the highest bit must be set on both the dwExtLowVersion and dwExtHighVersion parameters.
This causes the call to lineOpen to behave differently. The line is not actually opened, but waits for a lineDevSpecific call to complete the open with more information. The extra information required is provided in the CciscoLineDevSpecificPortRegistrationPerCall class.
Procedure
Step 1
Step 2
Step 3
Note
Class Details
class CCiscoLineDevSpecificPortRegistrationPerCall: public CCiscoLineDevSpecific{public:CCiscoLineDevSpecificPortRegistrationPerCall () :CCiscoLineDevSpecific(SLDST_USER_RECEIVE_RTP_INFO),m_RecieveIP(-1), m_RecievePort(-1), m_NumAffectedDevices(0){memset((char*)m_AffectedDeviceID, 0, sizeof(m_AffectedDeviceID));}virtual ~ CCiscoLineDevSpecificPortRegistrationPerCall () {}DWORD m_NumAffectedDevices;DWORD m_AffectedDeviceID[10];DWORD m_MediaCapCount;MEDIA_CAPS m_MediaCaps;virtual DWORD dwSize(void) const {return sizeof(*this)-4;} // subtract out the virtual function table pointer};Parameters
DWORD m_MsgType
Equals SLDST_USER_RECEIVE_RTP_INFO
DWORD m_NumAffectedDevices:
This value is returned by the TSP. It contains the number of deviceIDs in the m_AffectedDeviceID array which are valid. Any device with multiple directory numbers assigned to it will have multiple TAPI lines, one per directory number.
DWORD m_AffectedDeviceID[10]:
This value is returned by the TSP. It contains the list of deviceIDs for any device affected by this call. Do not call lineDevSpecific for any other device in this list.
DWORD m_mediaCapCount
The number of codecs supported for this line.
MEDIA_CAPS m_MediaCaps -
A data structure with the following format:
typedef struct {DWORD MediaPayload;DWORD MaxFramesPerPacket;DWORD G723BitRate;} MEDIA_CAPS[MAX_MEDIA_CAPS_PER_DEVICE];This data structure defines each codec supported on a line. The limit is 18. The following is a description for each member in the MEDIA_CAPS data structure:
MediaPayload is an enumerated integer containing one of the following values.
enum{Media_Payload_G711Alaw64k = 2,Media_Payload_G711Alaw56k = 3, // "restricted"Media_Payload_G711Ulaw64k = 4,Media_Payload_G711Ulaw56k = 5, // "restricted"Media_Payload_G722_64k = 6,Media_Payload_G722_56k = 7,Media_Payload_G722_48k = 8,Media_Payload_G7231 = 9,Media_Payload_G728 = 10,Media_Payload_G729 = 11,Media_Payload_G729AnnexA = 12,Media_Payload_G729AnnexB = 15,Media_Payload_G729AnnexAwAnnexB = 16,Media_Payload_GSM_Full_Rate = 18,Media_Payload_GSM_Half_Rate = 19,Media_Payload_GSM_Enhanced_Full_Rate = 20,Media_Payload_Wide_Band_256k = 25,Media_Payload_Data64 = 32,Media_Payload_Data56 = 33,Media_Payload_GSM = 80,Media_Payload_G726_32K = 82,Media_Payload_G726_24K = 83,Media_Payload_G726_16K = 84,// Media_Payload_G729_B = 85,// Media_Payload_G729_B_LOW_COMPLEXITY = 86,} Media_PayloadType;MaxFramesPerPacket should read as MaxPacketSize and is a 16 bit integer specified in milliseconds. It indicates the RTP packet size. Typically, this value is set to 20.
G723BitRate is a six byte field which contains either the G.723.1 information bit rate or is ignored. The values for the G.723.1 field are values enumerated as follows.
enum{Media_G723BRate_5_3 = 1, //5.3KbpsMedia_G723BRate_6_4 = 2 //6.4Kbps} Media_G723BitRate;Setting RTP Parameters for Call
CCiscoLineDevSpecific|+-- CCiscoLineDevSpecificSetRTPParamsForCallDescription
The CCiscoLineDevSpecificSetRTPParamsForCall class sets the RTP parameters for a specific call.
Note
Class Details
class CciscoLineDevSpecificSetRTPParamsForCall: public CCiscoLineDevSpecific{public:CciscoLineDevSpecificSetRTPParamsForCall () :CCiscoLineDevSpecific(SLDST_USER_SET_RTP_INFO) {}virtual ~ CciscoLineDevSpecificSetRTPParamsForCall () {}virtual DWORD dwSize(void) const {return sizeof(*this)-4;} // subtract out the virtual function table pointerDWORD m_RecieveIP; // UDP audio reception IPDWORD m_RecievePort; // UDP audio reception port};Parameters
DWORD m_MsgType
Equals SLDST_USER_SET_RTP_INFO
DWORD m_ReceiveIP
This is the RTP audio reception IP address in the network byte order to set for the call.
DWORD m_ReceivePort
This is the RTP audio reception port in the network byte order to set for the call.
Redirect Set Original Called ID
CCiscoLineDevSpecific|+-- CCiscoLineDevSpecificRedirectSetOrigCalledDescription
The CCiscoLineDevSpecificRedirectSetOrigCalled class redirects a call to another party while setting the original called ID of the call to any other party.
Note
Class Details
class CCiscoLineDevSpecificRedirectSetOrigCalled: public CCiscoLineDevSpecific{public:CCiscoLineDevSpecificRedirectSetOrigCalled () : CCiscoLineDevSpecific(SLDST_REDIRECT_SET_ORIG_CALLED) {}virtual ~ CCiscoLineDevSpecificRedirectSetOrigCalled () {}char m_DestDirn[25];char m_SetOriginalCalledTo[25];// subtract virtual function table pointervirtual DWORD dwSize(void) const {return (sizeof (*this) - 4) ;}Parameters
DWORD m_MsgType
Equals SLDST_REDIRECT_SET_ORIG_CALLED
char m_DestDirn[25]
Indicates the destination of the redirect. If this request is being used to transfer to voice mail, then set this field to the voice mail pilot number of the DN of the line whose voice mail you want to transfer to.
char m_SetOriginalCalledTo[25]
Indicates the DN to which the OriginalCalledParty needs to be set to. If this request is being used to transfer to voice mail, then set this field to the DN of the line whose voice mail you want to transfer to.
HCALL hCall (in lineDevSpecific parameter list)
Equals the handle of the connected call.
Join
CCiscoLineDevSpecific|+-- CCiscoLineDevSpecificJoinDescription
The CCiscoLineDevSpecificJoin class joins two or more calls into one conference call. Each of the calls being joined can either be in the ONHOLD or the CONNECTED call state.
The Cisco Unified CallManager may succeed in joining some of the calls specified in the Join request, but not all. In this case, the Join request will succeed and the Cisco Unified CallManager attempts to join as many calls as possible.
Note
Class Details
class CCiscoLineDevSpecificJoin : public CCiscoLineDevSpecific{public:CCiscoLineDevSpecificJoin () : CCiscoLineDevSpecific(SLDST_JOIN) {}virtual ~ CCiscoLineDevSpecificJoin () {}DWORD m_CallIDsToJoinCount;CALLIDS_TO_JOIN m_CallIDsToJoin;virtual DWORD dwSize(void) const {return sizeof(*this)-4;}// subtract out the virtual function table pointer};Parameters
DWORD m_MsgType
equals SLDST_JOIN
DWORD m_CallIDsToJoinCount
The number of callIDs contained in the m_CallIDsToJoin parameter.
CALLIDS_TO_JOIN m_CallIDsToJoin
A data structure that contains an array of dwCallIDs to join with the following format:
typedef struct {DWORD CallID; // dwCallID to Join} CALLIDS_TO_JOIN[MAX_CALLIDS_TO_JOIN];where MAX_CALLIDS_TO_JOIN is defined as:
const DWORD MAX_CALLIDS_TO_JOIN = 14;HCALL hCall (in LineDevSpecific parameter list)
equals the handle of the call that is being joined with callIDsToJoin to create the conference.
Set User SRTP Algorithm IDs
CCiscoLineDevSpecific|+-- CciscoLineDevSpecificUserSetSRTPAlgorithmIDDescription
The CciscoLineDevSpecificUserSetSRTPAlgorithmID class is used to allow applications to set SRTP algorithm IDs. To use this class, the lineNegotiateExtVersion API must be called before opening the line. When calling lineNegotiateExtVersion the highest bit or second highest bit must be set on both the dwExtLowVersion and dwExtHighVersion parameters. This causes the call to lineOpen to behave differently. The line is not actually opened, but waits for a lineDevSpecific call to complete the open with more information. The extra information required is provided in the CciscoLineDevSpecificUserSetSRTPAlgorithmID class.
Note
Procedure
Step 1
Step 2
Step 3
Step 4
Class Detail
class CciscoLineDevSpecificUserSetSRTPAlgorithmID: public CCiscoLineDevSpecific{public:CciscoLineDevSpecificUserSetSRTPAlgorithmID () :CCiscoLineDevSpecific(SLDST_USER_SET_SRTP_ALGORITHM_ID),m_SRTPAlgorithmCount(0),m_SRTP_Fixed_Element_Size(4){}virtual ~ CciscoLineDevSpecificUserSetSRTPAlgorithmID () {}DWORD m_SRTPAlgorithmCount; //Maximum is MAX_CISCO_SRTP_ALGORITHM_IDSDWORD m_SRTP_Fixed_Element_Size;//Should be size of DWORD, it should be always 4.DWORD m_SRTPAlgorithm_Offset; //offset from beginning of the message buffervirtual DWORD dwSize(void) const {return sizeof(*this)-4;} // subtract out the virtual function table pointer};Supported Algorithm Constants
enum CiscoSRTPAlgorithmIDs{SRTP_NO_ENCRYPTION=0,SRTP_AES_128_COUNTER=1};Parameters
DWORD m_MsgType
Equals SLDST_USER_SET_SRTP_ALGORITHM_ID
DWORD m_SRTPAlgorithmCount
This numbers of algorithm Ids specified in this message.
DWORD m_SRTP_Fixed_Element_Size
Should be size of DWORD, it should be always 4.
DWORD m_SRTPAlgorithm_Offset
Offset from the beginning of the message buffer. This is offset where you start put algorithm id array.
Note
Explicit Acquire
CCiscoLineDevSpecific|+--CCiscoLineDevSpecificAcquireDescription
The CCiscoLineDevSpecificAcquire class is used to explicitly acquire any CTI controllable device.
If an Superprovider app needs to open any CTI Controllable device on the Unified CM system. The app should explicitly acquire that device using the above interface. After successful response, it can open the device as usual.
Note
Class Details
class CCiscoLineDevSpecificAcquire : public CCiscoLineDevSpecific{public:CCiscoLineDevSpecificAcquire () : CCiscoLineDevSpecific(SLDST_ACQUIRE) {}virtual ~ CCiscoLineDevSpecificAcquire () {}char m_DeviceName[16];virtual DWORD dwSize(void) const {return sizeof(*this)-4;}// subtract out the virtual function table pointer};Parameters
DWORD m_MsgType
Equals SLDST_ACQUIRE
char m_DeviceName[16]
The DeviceName that needs to be explicitly acquired.
Explicit De-Acquire
CCiscoLineDevSpecific|+--CCiscoLineDevSpecificDeacquireDescription
The CCiscoLineDevSpecificDeacquire class is used to explicitly de-acquire the explicitly acquired device.
If an Superprovider app has explicitly acquired any CTI Controllable device on the Unified CM system, then the app should explicitly De-acquire that device using the above interface.
Note
Class Details
class CCiscoLineDevSpecificDeacquire : public CCiscoLineDevSpecific{public:CCiscoLineDevSpecificDeacquire () : CCiscoLineDevSpecific(SLDST_ACQUIRE) {}virtual ~ CCiscoLineDevSpecificDeacquire () {}char m_DeviceName[16];virtual DWORD dwSize(void) const {return sizeof(*this)-4;}// subtract out the virtual function table pointer};Parameters
DWORD m_MsgType
Equals SLDST_DEACQUIRE
char m_DeviceName[16]
The DeviceName that needs to be explicitly de-acquired.
Redirect FAC CMC
CCiscoLineDevSpecific | +--CCiscoLineDevSpecificRedirectFACCMCDescription
The CCiscoLineDevSpecificRedirectFACCMC class is used to redirect a call to another party that requires a FAC, CMC, or both.
Note
If the FAC is invalid, then the TSP will return a new device specific error code LINEERR_INVALIDFAC. If the CMC is invalid, then the TSP will return a new device specific error code LINEERR_INVALIDCMC.
Class Detail
class CCiscoLineDevSpecificRedirectFACCMC: public CCiscoLineDevSpecific{public:CCiscoLineDevSpecificRedirectFACCMC () : CCiscoLineDevSpecific(SLDST_REDIRECT_FAC_CMC) {}virtual ~ CCiscoLineDevSpecificRedirectFACCMC () {}char m_DestDirn[49];char m_FAC[17];char m_CMC[17];// subtract virtual function table pointervirtual DWORD dwSize(void) const {return (sizeof (*this) - 4) ;}Parameters
DWORD m_MsgType
Equals SLDST_REDIRECT_FAC_CMC
char m_DestDirn[49]
Indicates the destination of the redirect.
char m_FAC[17]
Indicates the FAC digits. If the application does not want to pass any FAC digits, then it must set this parameter to a NULL string.
char m_CMC[17]
Indicates the CMC digits. If the application does not want to pass any CMC digits, then it must set this parameter to a NULL string.
HCALL hCall (in lineDevSpecific parameter list)
Equals the handle of the call to be redirected.
Blind Transfer FAC CMC
CCiscoLineDevSpecific|+--CCiscoLineDevSpecificBlindTransferFACCMCDescription
The CCiscoLineDevSpecificBlindTransferFACCMC class is used to blind transfer a call to another party that requires a FAC, CMC, or both.
Note
If the FAC is invalid, then the TSP will return a new device specific error code LINEERR_INVALIDFAC. If the CMC is invalid, then the TSP will return a new device specific error code LINEERR_INVALIDCMC.
Class Detail
class CCiscoLineDevSpecificBlindTransferFACCMC: public CCiscoLineDevSpecific{public:CCiscoLineDevSpecificBlindTransferFACCMC () : CCiscoLineDevSpecific(SLDST_BLIND_TRANSFER_FAC_CMC) {}virtual ~ CCiscoLineDevSpecificBlindTransferFACCMC () {}char m_DestDirn[49];char m_FAC[17];char m_CMC[17];// subtract virtual function table pointervirtual DWORD dwSize(void) const {return (sizeof (*this) - 4) ;}Parameters
DWORD m_MsgType
Equals SLDST_BLIND_TRANSFER_FAC_CMC
char m_DestDirn[49]
Indicates the destination of the blind transfer.
char m_FAC[17]
Indicates the FAC digits. If the application does not want to pass any FAC digits, then it must set this parameter to a NULL string.
char m_CMC[17]
Indicates the CMC digits. If the application does not want to pass any CMC digits, then it must set this parameter to a NULL string.
HCALL hCall (in lineDevSpecific parameter list)
Equals the handle of the call to be blind transferred.
CTI Port Third Party Monitor
CCiscoLineDevSpecific|+-- CCiscoLineDevSpecificCTIPortThirdPartyMonitorDescription
The CCiscoLineDevSpecificCTIPortThirdPartyMonitor class is used for opening CTI ports in third party mode.
To use this class, the lineNegotiateExtVersion API must be called before opening the line. When calling lineNegotiateExtVersion the highest bit must be set on both the dwExtLowVersion and dwExtHighVersion parameters. This causes the call to lineOpen to behave differently. The line is not actually opened, but waits for a lineDevSpecific call to complete the open with more information. The extra information required is provided in the CCiscoLineDevSpecificCTIPortThirdPartyMonitor class.
Procedure
Step 1
Step 2
Step 3
Note
Class Detail
class CCiscoLineDevSpecificCTIPortThirdPartyMonitor: public CCiscoLineDevSpecific{public:CCiscoLineDevSpecificCTIPortThirdPartyMonitor () :CCiscoLineDevSpecific(SLDST_CTI_PORT_THIRD_PARTY_MONITOR) {}virtual ~ CCiscoLineDevSpecificCTIPortThirdPartyMonitor () {}virtual DWORD dwSize(void) const {return sizeof(*this)-4;} // subtract out the virtual function table pointer};Parameters
DWORD m_MsgType
equals SLDST_CTI_PORT_THIRD_PARTY_MONITOR
Send Line Open
CCiscoLineDevSpecific|+-- CciscoLineDevSpecificSendLineOpenDescription
The CciscoLineDevSpecificSendLineOpen class is used for general delayed open purpose. To use this class, the lineNegotiateExtVersion API must be called before opening the line. When calling lineNegotiateExtVersion the second highest bit must be set on both the dwExtLowVersion and dwExtHighVersion parameters. This causes the call to lineOpen to behave differently. The line is not actually opened, but waits for a lineDevSpecific call to complete the open with more information. The extra information required is provided in the CciscoLineDevSpecificUserSetSRTPAlgorithmID class.
Procedure
Step 1
Step 2
Step 3
Step 4
Note
Class Detail
class CciscoLineDevSpecificSendLineOpen: public CCiscoLineDevSpecific{public:CciscoLineDevSpecificSendLineOpen () :CCiscoLineDevSpecific(SLDST_SEND_LINE_OPEN) {}virtual ~ CciscoLineDevSpecificSendLineOpen () {}virtual DWORD dwSize(void) const {return sizeof(*this)-4;} // subtract out the virtual function table pointer};Cisco Phone Device Specific Extensions
Table 4-2 lists the subclasses of CiscoPhoneDevSpecific.
CCiscoPhoneDevSpecific
CCiscoPhoneDevSpecific|+-- CCiscoPhoneDevSpecificDataPassThroughDescription
This section provides information on how to perform Cisco TAPI specific functions with the CCiscoPhoneDevSpecific class, which is the parent class to all the following classes. It is a virtual class and is provided here for informational purposes.
Header File
The file CiscoLineDevSpecific.h contains the constant, structure and class definition for the Cisco phone device specific classes.
Class Detail
class CCiscoPhoneDevSpecific{public :CCiscoPhoneDevSpecific(DWORD msgType):m_MsgType(msgType) {;}virtual ~CCiscoPhoneDevSpecific() {;}DWORD GetMsgType (void) const { return m_MsgType;}void *lpParams(void) const {return (void*)&m_MsgType;}virtual DWORD dwSize(void) const = 0;private :DWORD m_MsgType ;}Functions
lpParms()
function can be used to obtain the pointer to the parameter block
dwSize()
function will give the size of the parameter block area
Parameter
m_MsgType
specifies the type of message.
Subclasses
Each subclass of CCiscoPhoneDevSpecific has a different value assigned to the parameter m_MsgType. If you are using C instead of C++, this is the first parameter in the structure.
Enumeration
Valid message identifiers are found in the CiscoPhoneDevSpecificType enumeration.
enum CiscoLineDevSpecificType {CPDST_DEVICE_DATA_PASSTHROUGH_REQUEST = 1};CCiscoPhoneDevSpecificDataPassThrough
CCiscoPhoneDevSpecific|+-- CCiscoPhoneDevSpecificDataPassThroughXSI enabled IP phones allow applications to directly communicate with the phone and access XSI features (e.g. manipulate display, get user input, play tone, etc.). In order to allow TAPI applications access to some of these XSI capabilities without having to setup and maintain an independent connection directly to the phone, TAPI will provide the ability to send device data through the CTI interface. This feature is exposed as a Cisco Unified TSP device specific extension.
PhoneDevSpecificDataPassthrough request is only supported for the IP phone devices. Application has to open a TAPI phone device with minimum extension version 0x00030000 to make use of this feature.
Description
The CCiscoPhoneDevSpecificDataPassThrough class is used to send the device specific data to CTI controlled IP Phone devices.
Note
Class Detail
class CCiscoPhoneDevSpecificDataPassThrough : public CCiscoPhoneDevSpecific{public:CCiscoPhoneDevSpecificDataPassThrough () :CCiscoPhoneDevSpecific(CPDST_DEVICE_DATA_PASSTHROUGH_REQUEST){memset((char*)m_DeviceData, 0, sizeof(m_DeviceData)) ;}virtual ~CCiscoPhoneDevSpecificDataPassThrough() {;}// data size determined by MAX_DEVICE_DATA_PASSTHROUGH_SIZETCHAR m_DeviceData[MAX_DEVICE_DATA_PASSTHROUGH_SIZE] ;// subtract out the virtual funciton table pointer sizevirtual DWORD dwSize (void) const {return (sizeof (*this)-4) ;}}Parameters
DWORD m_MsgType
equals CPDST_DEVICE_DATA_PASSTHROUGH_REQUEST.
DWORD m_DeviceData
This is the character buffer containing the XML data to be sent to phone device
Note
A phone can pass data to an application and it can be retrieved by using PhoneGetStatus (PHONESTATUS:devSpecificData). See PHONESTATUS description for further details.
CCiscoPhoneDevSpecificAcquire
CCiscoPhoneDevSpecific|+-- CCiscoPhoneDevSpecificAcquireDescription
The CCiscoPhoneDevSpecificAcquire class is used to explicitly acquire any CTI controllable device.
If an Superprovider app needs to open any CTI Controllable device on the Unified CM system. The app should explicitly acquire that device using the above interface. After successful response, it can open the device as usual.
Note
Class Details
class CCiscoPhoneDevSpecific Acquire : public CCiscoPhoneDevSpecific{public:CCiscoPhoneDevSpecificAcquire () : CCiscoPhoneDevSpecific (CPDST_ACQUIRE) {}virtual ~ CCiscoPhoneDevSpecificAcquire () {}char m_DeviceName[16];virtual DWORD dwSize(void) const {return sizeof(*this)-4;}// subtract out the virtual function table pointer};Parameters
DWORD m_MsgType
equals CPDST_ACQUIRE
char m_DeviceName[16]
The DeviceName that needs to be explicitly acquired.
CCiscoPhoneDevSpecificDeacquire
CCiscoPhoneDevSpecific|+-- CCiscoPhoneDevSpecificDeacquireDescription
The CCiscoPhoneDevSpecificDeacquire class is used to explicitly de-acquire an explicitly acquired device.
If a SuperProvider application has explicitly acquired any CTI Controllable device on the CallManager system, then the application should explicitly de-acquire that device using this interface.
Note
Class Details
class CCiscoPhoneDevSpecificDeacquire : public CCiscoPhoneDevSpecific{public:CCiscoPhoneDevSpecificDeacquire () : CCiscoPhoneDevSpecific (CPDST_ACQUIRE) {}virtual ~ CCiscoPhoneDevSpecificDeacquire () {}char m_DeviceName[16];virtual DWORD dwSize(void) const {return sizeof(*this)-4;}// subtract out the virtual function table pointer};Parameters
DWORD m_MsgType
equals CPDST_DEACQUIRE
char m_DeviceName[16]
The DeviceName that needs to be explicitly de-acquired.
CCiscoPhoneDevSpecificGetRTPSnapshot
CCiscoPhoneDevSpecific|+-- CCiscoPhoneDevSpecificGetRTPSnapshotDescription
The CCiscoPhoneDevSpecificGetRTPSnapshot class is used to request Call RTP snapshot event from the device. There will be LineCallDevSpecific event for each call on the device.
Note
Class Details
class CCiscoPhoneDevSpecificGetRTPSnapshot: public CCiscoPhoneDevSpecific{public:CCiscoPhoneDevSpecificGetRTPSnapshot () : CCiscoPhoneDevSpecific (CPDST_REQUEST_RTP_SNAPSHOT_INFO) {}virtual ~ CCiscoPhoneDevSpecificGetRTPSnapshot () {}char m_DeviceName[16];virtual DWORD dwSize(void) const {return sizeof(*this)-4;}// subtract out the virtual function table pointer};Parameters
DWORD m_MsgType
equals CPDST_DEACQUIRE
char m_DeviceName[16]
The DeviceName that needs to be explicitly de-acquired.
Messages
This section describes the line device specific messages that the Cisco Unified TSP supports.
Description
An application receives nonstandard TAPI messages in the following LINE_DEVSPECIFIC messages:
•
•
•
•
The message type is an enumerated integer with the following values:
enum CiscoLineDevSpecificMsgType{SLDSMT_START_TRANSMISION = 1,SLDSMT_STOP_TRANSMISION,SLDSMT_START_RECEPTION,SLDSMT_STOP_RECEPTION,SLDSMT_LINE_EXISTING_CALL,SLDSMT_OPEN_LOGICAL_CHANNEL,SLDSMT_CALL_TONE_CHANGED,SLDSMT_LINECALLINFO_DEVSPECIFICDATA,SLDSMT_NUM_TYPE};Start Transmission Events
SLDSMT_START_TRANSMISION
When a message is received, the RTP stream transmission should commence.
•
•
•
The application receives these messages to signal when to start streaming RTP audio. At extension version 1.0 (0x00010000), the parameters have the following format:
•
•
•
At extension version 2.0 (0x00020000), start transmission has the following format:
•
•
•
•
•
•
•
•
•
•
At extension version 4.0 (0x00040000), start transmission has the following format:
•
•
–
–
–
–
–
–
–
•
•
Start Reception Events
SLDSMT_START_RECEPTION
When a message is received, the RTP stream reception should commence.
•
•
•
When a message is received, the RTP stream reception should commence.
At extension version 1, the parameters have the following format:
•
•
•
At extension version 2 start reception has the following format:
•
•
•
•
•
•
•
•
At extension version 4.0 (0x00040000), start reception has the following format:
•
•
–
–
–
–
–
•
•
Stop Transmission Events
SLDSMT_STOP_TRANSMISION
When a message is received, transmission of the streaming should be stopped.
At extension version 1.0 (0x00010000), stop transmission has the following format:
•
At extension version 4.0 (0x00040000), stop transmission has the following format:
•
•
Stop Reception Events
SLDSMT_STOP_RECEPTION
When a message is received, reception of the streaming should be stopped.
At extension version 1.0 (0x00010000), stop reception has the following format:
•
At extension version 4.0 (0x00040000), stop reception has the following format:
•
•
Existing Call Events
SLDSMT_LINE_EXISTING_CALL
These events inform the application of existing calls in the PBX when it starts up. The format of the parameters is as follows:
•
•
•
Open Logical Channel Events
SLDSMT_OPEN_LOGICAL_CHANNEL
When a call has media established at a CTI Port or Route Point that is registered for Dynamic Port Registration, this message is received indicating that an IP address and UDP port number needs to be set for the call.
Note
The following is the format of the parameters:
•
•
•
•
LINECALLINFO_DEVSPECIFICDATA Events
SLDSMT_LINECALLINFO_DEVSPECIFICDATA
This message indicates DEVSPECIFICDATA information change in the DEVSPECIFIC portion of the LINECALLINFO structure for SRTP, QoS and Partition support.
Note
The format of the parameters is:
•
•
SLDSMT_LINECALLINFO_DEVSPECIFICDATA\•
SLDST_SRTP_INFO | SLDST_QOS_INFO | SLDST_PARTITION_INFO | SLDST_EXTENDED_CALL_INFOThe bit mask values are:
SLDST_SRTP_INFO = 0x00000001SLDST_QOS_INFO = 0x00000002SLDST_PARTITION_INFO = 0x00000004SLDST_EXTENDED_CALL_INFO = 0x00000008For example, if there are changes in SRTP and QoS but not in Partition, then both the SLDST_SRTP_INFO and SLDST_QOS_INFO bits will be set. The value for dwParam2 = SLDST_SRTP_INFO | SLDST_QOS_INFO = 0x00000011.
•
If there is a change in the SRTP Information, then this field would contain the CiscoSecurityIndicator.
enum CiscoSecurityIndicator{SRTP_MEDIA_ENCRYPT_KEYS_AVAILABLE,SRTP_MEDIA_ENCRYPT_USER_NOT_AUTH,SRTP_MEDIA_ENCRYPT_KEYS_UNAVAILABLE,SRTP_MEDIA_NOT_ENCRYPTED};
Note
Call Tone Changed Events
SLDSMT_CALL_TONE_CHANGED
When a tone change occurs on a call, this message is received indicating the tone and the feature that caused the tone change.
Note
The format of the parameters is as follows:
•
•
•
•
–
–
Note
Message Sequence Charts
This section illustrates a subset of the call scenarios supported by the Cisco Unified TSP. The event order is not guaranteed in all cases and can vary depending on the scenario and the event.
The following is a list of abbreviations used in the CTI events shown in each scenario.
•
•
•
•
•
•
Manual Outbound Call
Precondition
Party A is idle.
1. Party A goes offhook
NewCallEven
CH=C1,
GCH=G1,
Calling=A,
Called=NP,
OrigCalled=NP,
LR=NP,
State=Dialtone,
Origin=OutBound,
Reason=DirectLINE_APPNEWCALL
hDevice=A
dwCallbackInstance=0
dwParam1=0
dwParam2=hCall-1
dwParam3=OWNERLINECALLINFO (hCall-1)
hLine=A
dwCallID=T1
dwOrigin=OUTBOUND
dwReason=DIRECT
dwCallerID=A
dwCalledID=NP
dwConnectedID=NP
dwRedirectionID=NP
dwRedirectionID=NPCallStateChangedEvent,
CH=C1,
State=Dialtone,
Cause=CauseNoError,
Reason=Direct,
Calling=A,
Called=NP,
OrigCalled=NP,
LR=NPLINE_CALLSTATE
hDevice=hCall-1
dwCallbackInstance=0
dwParam1=DIALTONE
dwParam2=UNAVAIL
dwParam3=0No change
2. Party A dials Party B
CallStateChangedEvent,
CH=C1,
State=Dialing,
Cause=CauseNoError,
Reason=Direct,
Calling=A,
Called=NP,
OrigCalled=NP,
LR=NPLINE_CALLSTATE
hDevice=hCall-1
dwCallbackInstance=0
dwParam1=DIALING
dwParam2=0
dwParam3=0No change
3. Party B accepts call
CallStateChangedEvent,
CH=C1,
State=Proceeding,
Cause=CauseNoError,
Reason=Direct,
Calling=A,
Called=B,
OrigCalled=B,
LR=NPLINE_CALLSTATE
hDevice=hCall-1
dwCallbackInstance=0
dwParam1=PROCEEDING
dwParam2=0
dwParam3=0LINE_CALLINFO
hDevice=hCall-1
dwCallbackInstance=0
dwParam1=CALLEDID
dwParam2=0
dwParam3=0LINECALLINFO (hCall-1)
hLine=A
dwCallID=T1
dwOrigin=OUTBOUND
dwReason=DIRECT
dwCallerID=A
dwCalledID=B
dwConnectedID=NP
dwRedirectionID=NP
dwRedirectionID=NPCallStateChangedEvent,
CH=C1,
State=Ringback,
Cause=CauseNoError,
Reason=Direct,
Calling=A,
Called=B,
OrigCalled=B,
LR=NPLINE_CALLSTATE
hDevice=hCall-1
dwCallbackInstance=0
dwParam1=RINGBACK
dwParam2=0
dwParam3=0No change
4. Party B answers call
CallStateChangedEvent,
CH=C1,
State=Connected,
Cause=CauseNoError,
Reason=Direct,
Calling=A,
Called=B,
OrigCalled=B,
LR=NPLINE_CALLSTATE
hDevice=hCall-1
dwCallbackInstance=0
dwParam1=CONNECTED
dwParam2=ACTIVE
dwParam3=0LINE_CALLINFO
hDevice=hCall-1
dwCallbackInstance=0
dwParam1=CONNECTEDID
dwParam2=0
dwParam3=0LINECALLINFO (hCall-1)
hLine=A
dwCallID=T1
dwOrigin=OUTBOUND
dwReason=DIRECT
dwCallerID=A
dwCalledID=B
dwConnectedID=B
dwRedirectionID=NP
dwRedirectionID=NPCallStartReceptionEvent, DH=A, CH=C1
LINE_DEVSPECIFIC1
hDevice=hCall-1
dwCallBackInstance=0
dwParam1=StartReception
dwParam2=IP Address
dwParam3=PortNo change
CallStartTransmissionEvent, DH=A, CH=C1
LINE_DEVSPECIFIC2
hDevice=hCall-1
dwCallBackInstance=0
dwParam1=StartTransmission
dwParam2=IP Address
dwParam3=PortNo change
1 LINE_DEVSPECIFIC events are sent only if the application has requested them using lineDevSpecific()
2 LINE_DEVSPECIFIC events are sent only if the application has requested them using lineDevSpecific()
Blind Transfer
Precondition
A calls B. B answers. A and B are connected.
Redirect Set Original Called (TxToVM)
Precondition
A calls B. B answers. A and B are connected.
Shared Line Scenarios
Initiate a New Call Manually
Party A and Party A' are shared line appearances.
Party A and Party A' are idle.
Presentation Indication
Make a Call Through Translation Pattern
In the Translation pattern admin pages, both the callerID/Name and ConnectedID/Name are set to "Restricted".
Party A goes offhook
NewCallEvent,
CH=C1, GCH=G1,
Calling=A, Called=NP, OrigCalled=NP, LR=NP, State=Dialtone, Origin=OutBound, Reason=DirectLINE_APPNEWCALL
hDevice=A
dwCallbackInstance=0
dwParam1=0
dwParam2=hCall-1
dwParam3=OWNERLINECALLINFO (hCall-1)
hLine=A
dwCallID=T1
dwOrigin=OUTBOUND
dwReason=DIRECT
dwCallerID=A
dwCalledID=NP
dwConnectedID=NP
dwRedirectionID=NP
dwRedirectionID=NPCallStateChangedEvent, CH=C1, State=Dialtone, Cause=CauseNoError, Reason=Direct, Calling=A, Called=NP, OrigCalled=NP, LR=NP
LINE_CALLSTATE
hDevice=hCall-1
dwCallbackInstance=0
dwParam1=DIALTONE
dwParam2=UNAVAIL
dwParam3=0No change
Party A dials Party B through Translation pattern
CallStateChangedEvent, CH=C1, State=Dialing, Cause=CauseNoError, Reason=Direct, Calling=A, Called=NP, OrigCalled=NP, LR=NP
LINE_CALLSTATE
hDevice=hCall-1
dwCallbackInstance=0
dwParam1=DIALING
dwParam2=0
dwParam3=0No change
Party B accepts the call
CallStateChangedEvent, CH=C1, State=Proceeding, Cause=CauseNoError, Reason=Direct, Calling=A, CallingPartyPI=Allowed, Called=B, CalledPartyPI= Restricted, OrigCalled=B, OrigCalledPI=restricted, LR=NP
LINE_CALLSTATE
hDevice=hCall-1
dwCallbackInstance=0
dwParam1=
PROCEEDING
dwParam2=0
dwParam3=0LINE_CALLINFO
hDevice=hCall-1
dwCallbackInstance=0
dwParam1=CALLEDID
dwParam2=0
dwParam3=0LINECALLINFO (hCall-1)
hLine=A
dwCallID=T1
dwOrigin=OUTBOUND
dwReason=DIRECT
dwCallerID=A dwCallerIDName=A's Name
dwCalledID=B
dwCalledIDName=B's name dwConnectedID=NP
dwConnectedIDName=NP
dwRedirectionID=NP dwRedirectionIDName=NP
dwRedirectionID=NP dwRedirectionIDName=NPParty B accepts the call
(continued)CallStateChangedEvent, CH=C1, State=Ringback, Cause=CauseNoError, Reason=Direct, Calling=A, CallingPI = Allowed, Called=B, CalledPI = Restricted, OrigCalled=B, OrigCalledPI = Restricted, LR=NP
LINE_CALLSTATE
hDevice=hCall-1
dwCallbackInstance=0
dwParam1=RINGBACK
dwParam2=0
dwParam3=0LINECALLINFO (hCall-1)
hLine=A
dwOrigin=OUTBOUND
dwReason=DIRECT
dwCallerID=A
dwCalledID=B
dwConnectedIDFlags = LINECALLPARTYID_
BLOCKED dwConnectedID=NP
dwRedirectionID=NP
dwRedirectionIDFlags = LINECALLPARTYID_
BLOCKED dwRedirectionID=NPParty B answers the call
CallStateChangedEvent, CH=C1, State=Connected, Cause=CauseNoError, Reason=Direct, Calling=A, CallingPI = Allowed, Called=B, CalledPI = Restricted, OrigCalled=B, OrigCalledPI = Restricted, LR=NP
LINE_CALLSTATE
hDevice=hCall-1
dwCallbackInstance=0
dwParam1=CONNECTED
dwParam2=ACTIVE
dwParam3=0LINE_CALLINFO
hDevice=hCall-1
dwCallbackInstance=0
dwParam1=CONNECTEDID
dwParam2=0
dwParam3=0LINECALLINFO (hCall-1)
hLine=A
dwCallID=T1
dwOrigin=OUTBOUND
dwReason=DIRECT
dwCallerID=A dwCallerIDName=A's Name
dwCalledID=B dwCalledIDName=B's Name
dwConnectedID=A, dwConnectedIDName=
A's Name,
dwRedirectingID=NP
dwRedirectingIDName=NP
dwRedirectionIDFlags = LINECALLPARTYID_
BLOCKED dwRedirectionID=NP dwRedirectionIDName=NPCallStartReceptionEvent, DH=A, CH=C1
LINE_DEVSPECIFIC1
hDevice=hCall-1
dwCallBackInstance=0
dwParam1=
StartReception
dwParam2=IP Address
dwParam3=PortNo change
CallStartTransmissionEvent, DH=A, CH=C1
LINE_DEVSPECIFIC1
hDevice=hCall-1
dwCallBackInstance=0
dwParam1=
StartTransmission
dwParam2=IP Address
dwParam3=PortNo change
1 LINE_DEVSPECIFIC events are only sent if the application has requested for them using lineDevSpecific().
Blind Transfer Through Translation Pattern
A calls via translation pattern B.
B answers.
A and B are connected.
Forced Authorization and Client Matter Code Scenarios
Manual Call to a Destination that Requires a FAC
Preconditions
Party A is Idle. Party B requires an FAC.
Note that the scenario is similar if Party B requires a CMC instead of an FAC.
Manual Call to a Destination that Requires both FAC and CMC
Preconditions
Party A is Idle. Party B requires an FAC and a CMC.
lineMakeCall to a Destination that Requires a FAC
Preconditions
Party A is Idle. Party B requires an FAC. Note that the scenario is similar if Party requires a CMC instead of an FAC
lineMakeCall to a Destination that Requires Both FAC and CMC
Preconditions
Party A is Idle. Party B requires both a FAC and a CMC.
Timeout Waiting for FAC or Invalid FAC entered
Preconditions
Party A is Idle. Party B requires a FAC.
Note that the scenario is similar if Party B required a CMC instead of a FAC.
Party A does a lineMakeCall() to Party B.
NewCallEvent,
CH=C1,
GCH=G1,
Calling=A,
Called=NP,
OrigCalled=NP,
LR=NP,
State=Dialtone,
Origin=OutBound,
Reason=DirectLINE_CALLINFO
hDevice=hCall-1
dwCallbackInstance=0
dwParam1=ORIGIN
dwParam2=0
dwParam3=0LINE_CALLINFO
hDevice=hCall-1
dwCallbackInstance=0
dwParam1=
REASON, CALLERID
dwParam2=0
dwParam3=0LINECALLINFO (hCall-1)
hLine=A
dwCallID=T1
dwOrigin=OUTBOUND
dwReason=DIRECT
dwCallerID=A
dwCalledID=NP
dwConnectedID=NP
dwRedirectionID=NP
dwRedirectionID=NPCallStateChangedEvent, CH=C1,
State=Dialing,
Cause=CauseNoError,
Reason=Direct,
Calling=A,
Called=NP,
OrigCalled=NP,
LR=NPLINE_CALLSTATE
hDevice=hCall-1
dwCallbackInstance=0
dwParam1=DIALING
dwParam2=0
dwParam3=0No change
CallToneChangedEvent, CH=C1,
Tone=ZipZip,
Feature=FACCMC,
FACRequired=True,
CMCRequired=FalseLINE_DEVSPECIFIC
hDevice=hCall-1
dwCallbackInstance=0
dwParam1=SLDSMT_CALL_TONE_CHANGED
dwParam2=CTONE_ZIPZIP
dwParam3=
CZIPZIP_FACREQUIREDNo change
T302 timer times out waiting for digits or Party A does a lineDial() with an invalid FAC.
CallStateChangedEvent, CH=C1, State=Disconnected,
Cause=
CtiNoRouteToDDestination,
Reason=FACCMC,
Calling=A, Called=NP,
OrigCalled=NP, LR=NPLINE_CALLSTATE
hDevice=hCall-1
dwCallbackInstance=0
dwParam1=DISCONNECTED
dwParam2=DISCONNECT
MODE_FACCMC1
dwParam3=0No change
CallStateChangedEvent, CH=C1, State=Idle, Cause=CtiCauseNoError, Reason=Direct, Calling=A, Called=NP, OrigCalled=NP, LR=NP
LINE_CALLSTATE
hDevice=hCall-1
dwCallbackInstance=0
dwParam1=IDLE
dwParam2=0
dwParam3=0No change
Refer / Replaces Scenarios
In-Dialog Refer - Referrer in Cisco Unified CallManager Cluster
In-Dialog Refer Where ReferToTarget Redirects the Call in Offering State
In-Dialog Refer Where Refer Fails / Refer to Target is Busy
Out-of-Dialog Refer
Invite with Replace for Confirmed Dialog
Preconditions
A, B, and C are inside Cisco Unified CallManager. There is a confirmed dialog between A and B.
C initiates Invite to A with replace B's dialog id
Refer with Replace for All in Cluster
Preconditions
There is a confirmed dialog between A and B and A and C.
A initiates Refer to C with replace B's dialog id.
Refer with Replace for All in Cluster, Replace Dialog Belongs to Another Station
Preconditions
A is Referrer, D is Referee, and C is Refer-to-Target.
There is a confirmed dialog between A(d1) and B & C(d2) and D.
A initiates Refer to D on (d1) with Replaces (d2).
3XX scenario
Preconditions
Application is monitoring B.
SRTP Scenario
Media Terminate by Application (open secure CTI port or RP)
•
•
•
•
•
•
•
•
•
Media Terminate by TSP Wave Driver (open secure CTI port)
•
•
•
•
•
•
•
•
•
