DosBeep: Difference between revisions
Appearance
mNo edit summary |
mNo edit summary |
||
Line 5: | Line 5: | ||
===Parameters=== | ===Parameters=== | ||
; ULONG ''ulFrequency'' (input) | ; ULONG ''ulFrequency'' (input): The frequency in Hertz (Hz) of the beep to be generated. In the range of 0x25 to 0x7FFF (37 to 32767). | ||
: 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. | ||
; ULONG ''ulDuration'' (input) | |||
: The duration of the beep to be generated. In milliseconds. | |||
===Returns=== | ===Returns=== | ||
;APIRET rc | |||
*0 | *0 NO_ERROR | ||
*395 | *395 ERROR_INVALID_FREQUENCY | ||
===Include Info=== | ===Include Info=== | ||
Line 35: | Line 33: | ||
* [[DosDevConfig]] | * [[DosDevConfig]] | ||
* [[DosDevIOCtl]] | * [[DosDevIOCtl]] | ||
* [[DosPhysicalDisk]] | * [[DosPhysicalDisk]] | ||
[[Category:Dos]] | [[Category:Dos]] |
Latest revision as of 22:14, 7 January 2024
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 */