7526 DCT Reference

Reference&mdash.Speaker

SpkBeep

This function sounds the speaker.

C Format

     #include   "cfrapi26.h"            // For defined values
 
     USHORT     SpkBeep(volume, duration)
 
     UCHAR      volume                  // Speaker volume
     USHORT     duration                // Speaker duration in
                                        // Increments of 0.1 seconds
                                        // Range = 1-3275
 
     Returns:   E_OK                    // If no error occurred
                E_PARAM                 // If parameter values are incorrect
                E_DEVICE                // If speaker is busy

Masm Format

     Input:    ah = 4
               bl = 0   volume, default
                    1   volume, off
                    2   volume, low
                    3   volume, high
               cx = duration 1 = .1 seconds
 
     Call:     INT 43h
 
     Returns:  ax = 0       If no error occurred
                    1       If input parameters are incorrect
                    7       If speaker is busy

Comments:

Defined values for volume are:

00h    DEFAULT_VOLUME       Uses value set from keypad
01h    VOLUME_OFF
02h    VOLUME_LOW
03h    VOLUME_HIGH

Example

int far main (int funct,char far *params)

{

UCHAR volume;                 // Speaker volume
USHORT duration;              // Speaker duration in
                              // Increments of 0.1
·
// Beep the speaker for one second at high volume
volume = VOLUME_HIGH;
duration = 10;                // 10 x (.1 second) = one second
if (SpkBeep (volume, duration) == E_OK)

// Speaker beeped OK
·

else

// Handle error or speaker busy
·


}