GUI ScreenIO for Windows |
This API lets you play wave (.WAV) files.
This API will play the sound on the client. You must specify the location of the sound file on the server.
To play the sound on the server:
SET WIN32API-EXECUTE-API-ON-SERVER TO TRUE |
GUI ScreenIO saves some files in a cache directory on the client computer; the default location is:
C:\Windows\Temp_GUI_ScreenIO_Cache
If the file is found in the cache of the client machine, GUI ScreenIO will compare the file time with the file on the server. If they match, GUI ScreenIO will play the file in the client's cache.
If the file times do not match, GUI ScreenIO will transfer the file from the server to the client's cache, and then play the cached file.
Files available to copy to your system:
COPY WIN32API.
|
Note: To stop playback of a long .WAV file you previously started, move LOW-VALUE to PLAYSOUND-FILENAME and call this function again.
Filespec of the .WAV file to play; up to 1024 bytes.
To launch the sound and immediately return to your program:
SET PS-PLAY-ASYNCHRONOUS TO TRUE. |
To defer returning to your program until the sound has completed:
SET PS-PLAY-SYNCHRONOUS TO TRUE. |
To play the system default sound if the specified .WAV file is not found:
SET PS-PLAY-DEFAULT TO TRUE. |
To play nothing if the specified .WAV file is not found:
SET PS-PLAY-NODEFAULT TO TRUE. |
This argument is standard for all CALLs to GSWINAPI. It is used to select the desired API or function, and to return the status of the operation.
Used to return the status of a call to GSWINAPI. A value of zero is a failure, any other value indicates success.
Recommended usage is to test the 88-level value WIN32API to see if it worked, then to use the text error message to see why it failed.
* ------------------------: If function failed,
|
Error code that was returned by Windows. This is not generally useful unless you have the Windows Platform SDK documentation available to you.
Plain-text error message that describes why the operation failed.
The number of these present varies depending on how many arguments are used by the desired function. These are not used, but must be present because this CALL requires seven arguments.
© 2000-2019 Norcom, all rights reserved |