Sound Library

Edward Ballot (eballot@geoworks.com)
Wed, 2 Oct 1996 10:12:37 -0700 (PDT)

> book says SoundAllocSampleStream returns a MemHandle to the stream, but
> sound.h says it returns a word and takes a pointer to a MemHandle as a
> parameter. A lot of the functions return words. What do they mean?

Sorry, that is an oversight in the generation of the header file.
SoundAllocSampleStream() (and most of the other SoundXxx() routines)
return SoundError, which is one of the following:
#define SOUND_ERROR_NO_ERRORS 0
#define SOUND_ERROR_EXCLUSIVE_ACCESS_GRANTED 2
#define SOUND_ERROR_OUT_OF_MEMORY 4
#define SOUND_ERROR_UNABLE_TO_ALLOCATE_STREAM 6
#define SOUND_ERROR_HARDWARE_NOT_AVAILABLE 8
#define SOUND_ERROR_FAILED_ATTACH_TO_HARDWARE 10
#define SOUND_ERROR_HARDWARE_DOESNT_SUPPORT_FORMAT 12
#define SOUND_ERROR_DAC_UNATTACHED 14
#define SOUND_ERROR_STREAM_DESTROYED 16
#define SOUND_ERROR_STREAM_FULL 18

I'll log a bug report.

-Ed-