• PKX_CALL_TransferBridge no longer places the first call on hold. This must be done, if needed, explicitly by the application, by calling PKX_CALL_HoldRequest. Refer to Call Transfer for more information.
• Incoming SIP Invite messages are now authenticated if the user has configured authentication of incoming Registration messages.
• In SIP messages, the “from” field can be NULL, but if it is non-NULL, it MUST contain at least a username (which may or may not be valid). An IP address or hostname by itself is not allowed.
• Incoming SIP calls will no longer fail as "not found here" if no user is configured, since the call will be offered using the group default.
• A separate DNS lookup is no longer done for data in the “to” field of SIP messages in order to detect a hostname.
6
• PKX_CALL_MediaBridge will fail with PKX_ERROR_CALL_IN_WRONG_STATE if both calls are not in the connected state
• The following functions may be executed in any channel state (no longer requires IN_USE and PKX_ERROR_CHANNEL_IN_WRONG_STATE is no longer returned)
• PKX_CHANNEL_GetNumberOfDigits
• PKX_CHANNEL_GetDigits
• PKX_CHANNEL_ClearDigits
• PKX_CHANNEL_Record will no longer fail if the beep fails to play
• PKX_CHANNEL_Record and PKX_CHANNEL_RecordFile - silence detection will only be enabled if needed
• PKX_CHANNEL_Play and PKX_CHANNEL_PlayFile - silence detection will only be enabled if needed
• PKX_CONF_Create - low-level conference resources are now seized immediately, allowing bypass information to be retrieved as soon as this function returns.
• Channel broadcasting support changes the behavior of switch connections, allowing ones that were prevented before.
• Switch connections involving out-of-band digits involve the following changes (change went into 2.8 MR):
• If an out-of-band digit is received, that digit is immediately replicated inband. Previously, no inband digit was injected
• The SIP INFO event is not sent to the remote party until the received inband digit completes (in order to specify the proper digit duration). Peviously, the SIP INFO message was sent immediately.
• Only one virtual group is created in GrandPrix because groups are no longer defined in the configuration file.
• One of the object.system bits is now used for object locking and due to the large amount of object locking logs, users may no longer want to set object.system=0xffffffff. The object locking bit is not set when level=debug.
• SIP logs for the new Radvision protocol stack are located in the GP logs files, whereas log files for the OSIP protocol stack are located in the AoH log files.
• PKX_SYSTEM_Open:
• no longer returns:
• PKX_ERROR_GROUP_INVALID_PRODUCT
• PKX_ERROR_GROUP_MISSING_PRODUCT
• PKX_ERROR_PRODUCT_ALREADY_LOADED
• PKX_ERROR_PRODUCT_INVALID_LIBRARY 6
• PKX_ERROR_PRODUCT_NOT_SUPPORTED
• PKX_ERROR_PRODUCT_UNABLE_TO_FIND_LIBRARY
• PKX_ERROR_PRODUCT_UNABLE_TO_LOAD
• PKX_SYSTEM_Close causes active SIP calls to be dropped. GP sends either a BYE (for connected calls), a CANCEL (for proceeding calls), or reject(for alerting calls) messages.
• PKX_SYSTEM_Reload
• no longer returns:
• PKX_ERROR_PRODUCT_NOT_SUPPORTED
• PKX_ERROR_PRODUCT_UNABLE_TO_RELOAD
• PKX_ERROR_PRODUCT_NOT_LOADED
• PKX_SYSTEM_Start
• now returns:
• PKX_ERROR_LIBRARY_UNABLE_TO_START
• The Collection Group concept has been removed from the configuration files resulting in an increase in the number of groups presented in PKX_SYSTEM_GetConfig. PKX_SYSTEM_MAX_NUMBER_OF_GROUPS has increased from 32 to 64. Applications must now manage multiple groups that could route calls to the same location using the same protocol.
• PKX_CHANNEL_EnableToneDetection and PKX_CHANNEL_DisableToneDetection no longer return:
• PKX_ERROR_CHANNEL_INVALID_CAS_DETECTION_TONE_INDEX
• PKX_ERROR_CHANNEL_INVALID_AOB_DETECTION_TONE_INDEX
• PKX_CHANNEL_PlayTone
• now returns:
• PKX_ERROR_OUT_OF_MEMORY
• no longer returns:
• PKX_ERROR_SYSTEM_NO_GENERATION_TONES_DEFINED
• PKX_CHANNEL_PlayTonePattern no longer returns:
• PKX_ERROR_SYSTEM_NO_GENERATION_TONE_PATTERNS_DEFINED
• The following functions now return PKX_ERROR_OUT_OF_MEMORY:
• PKX_CHANNEL_RingingStart
• PKX_CHANNEL_PlayTone
• PKX_CHANNEL_PlayDigits
• PKX_CHANNEL_HalfDuplexConnect
6
• PKX_CHANNEL_FaxAddDocument
• PKX_CONF_Create
• PKX_CONF_AddMember
• PKX_CONF_ChangeMember
• PKX_CHANNEL_GetBypassInfo now returns:
• PKX_ERROR_CHANNEL_BYPASS_INFO_NOT_READY
• The following functions no longer return PKX_ERROR_PRODUCT_NOT_SUPPORTED:
• PKX_CHANNEL_GetConfig
• PKX_CHANNEL_SetConfig now returns:
• PKX_ERROR_CHANNEL_ECHO_CANCEL_FAILED_TO_ENABLE
• PKX_ERROR_CHANNEL_ECHO_CANCEL_FAILED_TO_DISABLE
• PKX_CONF_Destroy no longer returns PKX_ERROR_PRODUCT_NOT_LOADED
• PKX_CONF_AddMember:
• no longer returns:
• PKX_ERROR_CHANNEL_INVALID_REMOTE_HANDLE
• PKX_ERROR_PRODUCT_NOT_LOADED
• now returns:
• PKX_ERROR_CONF_INVALID_CHANNEL
• PKX_ERROR_OUT_OF_MEMORY
• PKX_CONF_RemoveMember and PKX_CONF_ChangeMember no longer return:
• PKX_ERROR_CHANNEL_INVALID_REMOTE_HANDLE
• PKX_ERROR_PRODUCT_NOT_LOADED 6
• PKH_RTP_SetConfig now returns:
• PKH_ERROR_RTP_CANNOT_CHANGE_DIFF_SERV_WHEN_ACTIVE
• PK_API PKH_RTP_SendNamedEvent now returns:
• PKH_ERROR_RTP_NOT_STARTED
• PKH_RTP_GetStatus
• now returns PKH_ERROR_RTP_STATUS_NOT_AVAILABLE
• no longer returns PKH_ERROR_RTP_STATUS_NOT_ENABLED
• PKH_FAX_Stop now returns PKH_ERROR_FAX_ALREADY_STOPPED