Dialogic 05-2548-006 用户手册

21

Dialogic Corporation

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 

, on page 32 of this Release Update for more information on 

using these coders in 3PCC mode.

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.