The datatype for the a_CapabilitiesArray[] parameter is a union, IPM_CAPABILITIES, which is defined as follows:

typedef struct ipm_capabilities_tag

{

unsigned int version; union

{

IPM_CODER_INFO Coder; // Future types here.

};

}IPM_CAPABILITIES;

In this union, the IPM_CODER_INFO data structure provides coder details such as coder type, frame size, number of frames per packet, VAD enable/disable information, and payload-related information.

The datatype for the a_CapType parameter is eCAPABILITY_TYPE, an enumeration that is defined as follows:

enum eCAPABILTIY_TYPE

{

CAPABILITY_CODERLIST;

}

The ipm_GetCapabilities( ) function is supported in synchronous mode only. If asynchronous mode (a_usMode = EV_ASYNC) is specified, an error is generated.

„Cautions

None.

„Errors

If the function returns -1 to indicate failure, call ATDV_LASTERR( ) or ATDV_ERRMSGP( ) to return one of the following errors:

EIPM_BADPARM Invalid parameter

EIPM_INTERNAL Internal error

EIPM_INV_MODE Invalid mode

EIPM_INV_STATE

Invalid state. Initial command did not complete before another function call was made.

EIPM_ERROR System error

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

Page 28
Image 28
Dialogic 05-2548-006, DIALOGIC MULTIMEDIA SOFTWARE FOR ADVANCEDTCA RELEASE 1.0 manual „ Cautions