CA_Get_Segment_Info()

Purpose

Retrieves segment voice data information.

Libraries

Blueworx Voice Response library (libvae.a)

Custom Server library (libca.a)

Syntax

#include "CA_header.h"
#include "CA_access_db.h"
int CA_Get_Segment_Info (
 SEGMENT_PARM_ST  *segment_parm_sp,
 SEGMENT_INFO_ST  *segment_info_sp
);

Description

This subroutine calculates the total number of voice elements required to hold the segment. The length of a voice element is UNCOMPRESSED_ELEMENT_LENGTH for uncompressed data and COMPRESSED_ELEMENT_LENGTH for compressed data.

Parameters

segment_parm_sp

A pointer to a SEGMENT_PARM_ST input structure that is filled in as described in SEGMENT_PARM_ST.

segment_info_sp

A pointer to a SEGMENT_INFO_ST output structure that will be filled in as described in SEGMENT_INFO_ST.

Return codes

0

Successful

-1

Unsuccessful (global error number CA_errno is set to indicate the error)

Error names

CA_ACCESS_NOBUFS
CA_CHECK_LANG_FAILED
CA_INV_ADDR
CA_INV_COMPRESSION_TYPE
CA_INV_REQUEST
CA_INV_SEGMENT_ID
CA_LANG_NOT_FOUND
CA_LANG_NOT_IN_USE
CA_NO_MSG_RECV
CA_NOT_INIT
CA_OM_REQ_FAILED
CA_REQ_FAILED
CA_SEGMENT_NOT_FOUND
CA_SGMT_TEXT_OPERATION_FAILED
CA_TERMINATING

Related information

CA_Create_Segment(), CA_Delete_Segment(), CA_Get_Segment().