dsh_ChannelLoad

__stdcall dsh_ChannelLoad(
char* lpszResource,
CHANNELID channel,
INT flags
);

Parameters

lpszResource
Wave file / Ogg Vorbis (.ogg) file or resource (currently not implemented!)

channel
Specifies the channel which should load the wave. If DSH_SEEKFREECHANNEL is specified, this parameter is ignored.

flags
One or more of the following:

DSH_SEEKFREECHANNEL: Function automatically seeks an free channel. Recommended.

DSH_RESOURCE: lpszResource is a resource name. This is not supported at the moment.

DSH_FILE: Default. lpszResource is a filename. If you don´t specify DSH_RESOURCE, this flag is set automatically.

DSH_OGG: Force Ogg Vorbis format


Return Values

Returns DSHRES_OK if successful. Other return values are DSHRES_GENERALERROR, DSHRES_NOTFREE, DSHRES_NOWAVE, DSHRES_NOTINIT and DSHRES_CANTCREATEBUFFER. If DSHRES_NOWAVE is returned, this means that the wave/ogg file could not be loaded.

Remarks

Resource waves/ogg´s are currently not supported. If you specify a resource, the function will return DSHRES_GENERALERROR. To decode Ogg Vorbis files, the file must have the extension ".ogg" or DSH_OGG must be specified.

See also

dsh_ChannelUnload