ICELIB0.NLM → ICE_PlaySound()

ICE_PlaySound

Description:

Plays the specified frequency on the PC Speaker for the specified period of time.

Syntax for C:

void *ICE_PlaySound (
unsigned int frequency,
unsigned int duration,
unsigned int flags
);

Syntax for Assembly:

Call ICE_PlaySound C, [frequency], [duration], [flags]

Parameters:

frequency: (IN) Valid frequency, ranging from 37 to 32767.
duration: (IN) Length of sound, with same timing as delay() function, ranging from 1 to 10000.
flags: (IN) All undocumented bit flags are considered reserved for future use, and should remain cleared (0) to ensure upward compatibility with newer versions of ICELIB0.NLM. Currently supported flags are none.

Returns:

0 = Successful
1 = Frequency out of range
2 = Duration out of range

Remarks:

In some circumstances, the first sound may play longer than expected. Calling the delay() function prior to the first sound has resolved it for us. On busy servers, however, this may not be as effective. At this time, there are no plans to ensure accurate timing because PC Speaker sound is not considered to be critical on servers.

Resource files:

icelib0.imp