Intermec 5055 Reference Guide

Page of 216
im_sound
5-70
im_sound
Purpose:
This function generates a beep of specified pitch and duration. For example, use no
beep or a short beep for library use, a long beep for manufacturing use, or a unique beep
to distinguish among other 5055s.
Syntax:
#include "im5055.h"
IM_STATUS im_sound
    (IM_USHORT 
pitch
,
    IM_USHORT
 duration,
    
IM_USHORT
 volume)
;
IN Parameters:
pitch    Specifies the frequency of the beep you want the 5055 to make. Either enter a
number from 20 to 8189 to indicate the pitch, or choose one of these constants:
IM_HIGH_PITCH    2400 Hz.
IM_LOW_PITCH    1200 Hz.
IM_VERY_LOW_PITCH    600 Hz.
duration    Specifies the length of the beep. Either enter a number from 2 to 79,999 ms
to indicate the duration of the beep, or choose one of these constants:
IM_BEEP_DURATION    50 ms.
IM_CLICK_DURATION    5 ms.
volume    Specifies the volume. Choose one of these constants:
IM_OFF_VOLUME    Off.
IM_QUIET_VOLUME    Quiet.
IM_NORMAL_VOLUME     Normal.
IM_LOUD_VOLUME    Loud.
IM_EXTRA_LOUD_VOLUME    Extra loud.
IM_CURRENT_VOLUME    Use volume from configuration menu.
OUT Parameters:
None.
Return Value:
This function returns one of these codes:
IM_SUCCESS    Successful beep.
IM_INVALID_PITCH    Pitch is outside the allowed range.
IM_INVALID_VOLUME    Volume is outside the allowed range.
Notes:
If the IN parameters are not working, change the pitch, duration, and volume through
the Control Panel on the 5055.