Play Sound File

Added May 2013

? tab(-10, AG_PLAYSOUND); fspec, flags {,rtnsts}; chr(127);

AG_PLAYSOUND (105) forces the ATE client to play a sound file.

fspec and flags are the same as for the MX_PLAYSOUND. rtnsts 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.

Possible response values:

Value	Description*
1	Success
0	file (fspec) not found
-98	Unable to load winmm.dll
-99	DLL loaded bu unable to link to PlaySound function