3.3.7Dialogic® Global Call IP Technology Guide

Update to Section 4.3.2, Setting Coder Information

In Table 2, “Coders Supported for Dialogic® Host Media Processing (HMP) Software,” the following note should be added:

Global Call supports AMR-NB and EVRC coders in third-party call control (3PCC) mode only. These coder types cannot be explicitly set using the Global Call API, but can be specified using the IP Media Library (IPML) API.

See the documentation updates in Section 3.3.9, “Dialogic® IP Media Library API Programming Guide”, on page 32 of this Release Update for more information on using these coders in 3PCC mode.

3.3.8Dialogic® IP Media Library API Library Reference

Update to the ipm_GetCTInfo( ) function

For the ATCA Multimedia Platform, a value of CT_DFHMPATCA is returned in the device family field of the CT_DEVINFO data structure.

Update to the ipm_GetLocalMediaInfo( ) function

This function returns an invalid state error if a coder is not reserved prior to calling the ipm_GetLocalMediaInfo( ) function. All audio/video coders must be reserved using the dev_ReserveResourceEx( ) Dialogic® Device Management API library function prior to use of the ipm_GetLocalMediaInfo( ) function.

Note: The restriction above does not apply when using a fax (T.38) media type. The ipm_GetLocalMediaInfo( ) can be called successfully to retrieve fax port information without using a preceding call to dev_ReserveResourceEx( ).

The following information, relating to ipm_GetLocalMediaInfo( ), should also be included.

For the audio/video media types, only RTP information needs to be queried. RTCP information is automatically provided when querying for RTP.

Update to the ipm_GetLocalMediaInfo( ) function

Remove the first caution of the ipm_GetLocalMediaInfo( ) function (on page 27) and add the following text to the Description section. This clarifies eMediaType and unCount as members of data structures referenced by the pMediaInfo function parameter and enumerates the allowed values for the eMediaType field (in the IPM_MEDIA data structure) and corresponding unCount values.

To retrieve RTP port information for both audio and video in a multimedia session, set the eMediaType fields to MEDIATYPE_AUDIO_LOCAL_RTP_INFO and MEDIATYPE_VIDEO_LOCAL_RTP_INFO respectively and unCount to 2. See the code example. [Corrected below.]

To retrieve RTP port information for a video-only session, set the eMediaType field to MEDIATYPE_VIDEO_LOCAL_RTP_INFO and unCount to 1.

To retrieve RTP port information for an audio-only session, set the eMediaType field to MEDIATYPE_AUDIO_LOCAL_RTP_INFO and unCount to 1.

Dialogic® Multimedia Software for ATCA Release 1.0 Release Update, Rev 06 — January 23, 2008

21

Dialogic Corporation

 

Page 21
Image 21
Dialogic DIALOGIC MULTIMEDIA SOFTWARE FOR ADVANCEDTCA RELEASE 1.0, 05-2548-006 Dialogic Global Call IP Technology Guide