DosBeep: Difference between revisions
m Ak120 moved page OS2 API:CPI:DosBeep to DosBeep |
mNo edit summary |
||
| Line 1: | Line 1: | ||
To produce a beep from the speaker DosBeep is called with the frequency and the length of the beep as arguments. | To produce a beep from the speaker DosBeep is called with the frequency and the length of the beep as arguments. | ||
==Syntax== | |||
DosBeep( ''ulFrequency'', ''ulDuration'' ) | |||
===Parameters=== | ===Parameters=== | ||
| Line 13: | Line 12: | ||
===Returns=== | ===Returns=== | ||
APIRET rc | APIRET rc | ||
*0 NO_ERROR | |||
*395 ERROR_INVALID_FREQUENCY | |||
===Include Info=== | ===Include Info=== | ||
| Line 21: | Line 20: | ||
===Sample Code=== | ===Sample Code=== | ||
<code> | |||
#define INCL_DOSPROCESS | #define INCL_DOSPROCESS | ||
#include <os2.h> | #include <os2.h> | ||
| Line 30: | Line 30: | ||
} /* be called now when the */ | } /* be called now when the */ | ||
/* frequency is 400 Hz */ | /* frequency is 400 Hz */ | ||
</code> | |||
===See Also=== | ===See Also=== | ||
Revision as of 16:32, 28 February 2017
To produce a beep from the speaker DosBeep is called with the frequency and the length of the beep as arguments.
Syntax
DosBeep( ulFrequency, ulDuration )
Parameters
- ULONG ulFrequency (input)
- The frequency in Hertz (Hz) of the beep to be generated. In the range of 0x25 to 0x7FFF (37 to 32767).
- ULONG ulDuration (input)
- The duration of the beep to be generated. In milliseconds.
Returns
APIRET rc
- 0 NO_ERROR
- 395 ERROR_INVALID_FREQUENCY
Include Info
#define INCL_DOSPROCESS #include <os2.h>
Sample Code
#define INCL_DOSPROCESS
#include <os2.h>
#include <stdio.h> /* For printf */
if(DosBeep(400, 300)) /* Beep a 400 Hz tone for 0.3 seconds */
{
printf("Invalid frequency to DosBeep()\n"); /* In case of error, should not */
} /* be called now when the */
/* frequency is 400 Hz */