Please enable JavaScript to view this site.

A-Shell Consolidated Reference

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