DosBeep

This call generates sound from the speaker.

Syntax

DosBeep (Frequency, Duration)

Parameters

Frequency (USHORT) - input : Tone in Hertz (cycles per second) in the range 37 through 32767.

Duration (USHORT) - input : Length of the sound in milliseconds.

Return Code

rc (USHORT) - return Return code descriptions are:

0 NO_ERROR

395 ERROR_INVALID_FREQUENCY

Remarks

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 */

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);

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

Note

Text based on http://www.edm2.com/index.php/OS2_API:CPI:LEGACY:DosBeep