Dialogic DIALOGIC MULTIMEDIA SOFTWARE FOR ADVANCEDTCA RELEASE 1.0 Computer Accessories User Manual


 
Dialogic
®
Multimedia Software for ATCA Release 1.0 Release Update, Rev 06 — January 23, 2008 21
Dialogic Corporation
3.3.7 Dialogic
®
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.8 Dialogic
®
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.