Table of Contents
This is part of Family API which allow to create dual-os version of program runs under OS/2 and DOS
Note: This is legacy API call. It is recommended to use 32-bit equivalent
DosBeep
This call generates sound from the speaker.
Syntax
DosBeep (Frequency, Duration)
Parameters
Return Code
rc (USHORT) - return Return code descriptions are:
- 0 NO_ERROR
- 395 ERROR_INVALID_FREQUENCY
Notes
DosBeep executes synchronously. An application program that invokes DosBeep waits until the specified number of milliseconds expire before it resumes execution.
Example Code
C Binding
#define INCL_DOSPROCESS USHORT rc = DosBeep(Frequency, Duration); USHORT Frequency; /* Hertz (Hz) */ USHORT Duration; /* Length of sound */ USHORT rc; /* return code */
MASM Binding
EXTRN DosBeep:FAR INCL_DOSPROCESS EQU 1 PUSH WORD Frequency ;Frequency (in Hertz) PUSH WORD Duration ;Length of sound (in milliseconds) CALL DosBeep
Returns WORD
Example
This example generates a beep for 1 second (1,000 milliseconds) at a frequency of 1,380.
#define INCL_DOSPROCESS #define BEEP_FREQUENCY 1380 #define BEEP_DURATION 1000 USHORT rc; rc = DosBeep(BEEP_FREQUENCY, BEEP_DURATION);
Note
Text based on http://www.edm2.com/index.php/OS2_API:CPI:LEGACY:DosBeep