AG_PLAYSOUND
Reviewed and revised December 2023
tab(-10, AG_PLAYSOUND); fspec, flags {,status}; chr(127); Tab(-10,x) Syntax Notes
AG_PLAYSOUND (105) forces the ATE client to play a sound file.
This function has both a subroutine and a print tab implementation.
Parameters
fspec and flags are the same as for the MX_PLAYSOUND. status may be set to non-zero if you want to get the return status in the keyboard buffer. Otherwise (if 0 or omitted), there is no response.
Note that fspec must be a PC native filespec, and that AG_PLAYSOUND supports the standard image file search path and %env% variables.
Response
None, unless status is "1", in which case the response will be the string representation of one of the following values followed by <CR>:
Value |
Description* |
|---|---|
1 |
Success |
0 |
file (fspec) not found |
-98 |
Unable to load winmm.dll |
-99 |
DLL loaded but unable to link to PlaySound function |
See Also
History
2013 November, A-Shell 6.1.1367: Command added to A-Shell
