PLAYWAVE

Syntax

INT = PLAYWAVE(name as ANYTYPE,flags as UINT)

Description

Plays a .WAV sound loaded from file or memory.

Parameters

name - String containing filename or a MEMORY variable with the loaded sound file.

flags - Playback flags.

Return value

.TRUE (1) if sound could be started or FALSE (0) if the sound hardware was busy.

Remarks

Valid values for flags are:

@SNDASYNC - The sound is played asynchronously and the function returns immediately after beginning the sound.

@SNDSYNC - The sound is played synchronously and the function does not return until the sound ends.

@SNDLOOP - The sound plays repeatedly. You must also specify @SNDASYNC

@SNDNOSTOP - If a sound is currently playing, the function immediately returns FALSE, without playing the requested sound.

To stop a sound use an empty string for the name or use NULL:

PLAYWAVE(NULL, 0)

Example usage

PLAYWAVE "c:\\media\\bark.wav", @SNDASYNC