Jump to content

DosBeep: Difference between revisions

From EDM2
Ak120 (talk | contribs)
mNo edit summary
Ak120 (talk | contribs)
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
;APIRET  rc
*0 NO_ERROR
*0 NO_ERROR
*395 ERROR_INVALID_FREQUENCY
*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          */

See Also