|
|
IVR Software Library
ivr_menu
Database Systems Corp. (DSC) provides an API subroutine library of IVR Software routines that perform phone functions The following is a description of one of the functions within this library that controls the IVR operation - ivr_menu.
The routine is from our C programming library, although this same routine has an equivalent for Visual Basic, .NET, C++ and Active-X. DSC provides a separate user guide for each of these languages.
Contact DSC to obtain the most current IVR manuals in your required programming language.
ivr_menu()
int
ivr_menu(int call, char **prompts, int numprompts, int allow_interrupt, int
max_digits, int timeout, char termchar, int clear, IVRDIGITS
*ivrd)
The
ivr_menu function plays a series of menu items and retrieves the digits
from the specified call.
Parameters
|
int
|
call
|
Specifies
which call to retrieve digits from. It can be one of the following values.
CALL_PRIMARY: Collect Digits from the Primary Call
CALL_SECONDARY: Collect Digits from the Secondary Call
|
|
char **
|
prompts
|
Array of null terminated string containing the pathnames
of the prompts to play.
|
|
int
|
numprompts
|
Number of prompts in the prompts array.
|
|
int
|
allow_interrupt
|
Specifies
if a digit can interrupt the prompts. It can be one of the following values.
NO_INTERRUPT: Do not allow prompts to be interrupted by a digit
INTERRUPT: Allow prompts to be interrupted by a digit
|
|
int
|
max_digits
|
The maximum number of digits to return. This must be less
than 32.
|
|
int
|
timeout
|
The maximum amount of time in seconds to wait for the
digits to be entered.
|
|
char
|
termchar
|
A specific character to terminate digit collection.
|
|
int
|
clear
|
Clear the buffer before digit collection. It can be one of
the following values.
NO_CLEAR: Do NOT clear the buffer before digit collection
CLEAR: Clear the buffer before digit collection
|
|
IVRDIGITS *
|
ivrd
|
Structure of type IVRDIGITS
in which the digits will be returned.
|
Return Value
Returns
IVR_SUCCESS on a successful function call. On error the function returns one
of the IVR Error Codes.
Example
char *prompts[129] = {
"D:\\ivrdemo\\prompt1.wav",
"D:\\ivrdemo\\prompt2.wav",
"D:\\ivrdemo\\prompt3.wav",
"D:\\ivrdemo\\prompt4.wav"
};
IVRDIGITS ivrd;
if(ivr_menu(CALL_PRIMARY,prompts,4,INTERRUPT,1,15, '*',NO_CLEAR,&ivrd) != IVR_SUCCESS){ ...handle error; }
|
|
