MS_DataInfo

---

typedef struct ms_DataInfo
{
     unsigned int    version;
     eMSSendDataType dataType;    /* Data Type - FSK  */
     union
     {
          char* dataString;
     }uInfo;
} MS_DataInfo, *MS_DataInfoPtr; 

Description

This structure is used by the ms_SendData( ) function. It contains call information and is used to transmit data about an incoming call to a station that is already in a call. This operation is commonly called call waiting caller ID.

Field Descriptions

The fields of the MS_DataInfo data structure are described as follows:

version

reserved for future use. Set to 0.

dataType

type of data to be sent. Values include:

• eMSInvalidDataType

  RFU

• eMSFSK

  FSK (frequency shift keyed) data

• eMSMaxDataType

  RFU

DataString

ASCII character string that holds information about the origination party. The maximum length is 127 characters. The following sub-fields are supported when sending an FSK caller ID string:

• Caller Name

  identifies the name of the call originator if available.

• Caller Name Absence Reason

  identifies why call originator's name is not available. Possible reasons are Private (P) or Out of Area (O).

• Caller Number

  identifies the number of the call originator if available.

• Caller Number Absence Reason

  identifies why call originator's number is not available. Possible reasons are Private (P) or Out of Area (O).

• Date Time

  identifies the date and time at which the call is sent.

Sub-group identifiers with format X: are used to specify sub-fields for caller ID transmission. Note that the user strings embed this character as part of sub-field identifiers. Thus this sub-group identifier is implicit by nature.

A: Identifies beginning of Caller Number Absence Reason sub-field.

B: Identifies beginning of Caller Name Absence Reason sub-field.

I: Identifies beginning of Caller Number sub-field.

N: Identifies beginning of Caller Name sub-field.

T: Identifies beginning of Time and Date sub-field

Notes:

1. Use the character "/" as an escape character to indicate that ":" is part of the string. For example, Next string "N:J/:NamathI:993-3000" uses escape the character "/" to embed the name "J:Namath".
2. The end of a sub-field is recognized by the character ":" or the end of string when a sub-field is located at the end of the string.

Click here to contact Telecom Support Resources