comparison SDL_sound_internal.h @ 387:fb519e6028e3

Changed all the Sound_SetError() calls to __Sound_SetError (or BAIL*_MACRO)
author Ryan C. Gordon <icculus@icculus.org>
date Fri, 05 Jul 2002 23:11:51 +0000
parents cbb15ecf423a
children c42ac9ee2ce4
comparison
equal deleted inserted replaced
386:8c8ecd1008c9 387:fb519e6028e3
161 * 161 *
162 * If there's just no more data (end of file, etc), then do: 162 * If there's just no more data (end of file, etc), then do:
163 * sample->flags |= SOUND_SAMPLEFLAG_EOF; 163 * sample->flags |= SOUND_SAMPLEFLAG_EOF;
164 * 164 *
165 * If there's an unrecoverable error, then do: 165 * If there's an unrecoverable error, then do:
166 * Sound_SetError(ERR_EXPLAIN_WHAT_WENT_WRONG); 166 * __Sound_SetError(ERR_EXPLAIN_WHAT_WENT_WRONG);
167 * sample->flags |= SOUND_SAMPLEFLAG_ERROR; 167 * sample->flags |= SOUND_SAMPLEFLAG_ERROR;
168 * 168 *
169 * If there's more data, but you'd have to block for considerable 169 * If there's more data, but you'd have to block for considerable
170 * amounts of time to get at it, or there's a recoverable error, 170 * amounts of time to get at it, or there's a recoverable error,
171 * then do: 171 * then do:
172 * Sound_SetError(ERR_EXPLAIN_WHAT_WENT_WRONG); 172 * __Sound_SetError(ERR_EXPLAIN_WHAT_WENT_WRONG);
173 * sample->flags |= SOUND_SAMPLEFLAG_EAGAIN; 173 * sample->flags |= SOUND_SAMPLEFLAG_EAGAIN;
174 * 174 *
175 * SDL_sound will not call your read() method for any samples with 175 * SDL_sound will not call your read() method for any samples with
176 * SOUND_SAMPLEFLAG_EOF or SOUND_SAMPLEFLAG_ERROR set. The 176 * SOUND_SAMPLEFLAG_EOF or SOUND_SAMPLEFLAG_ERROR set. The
177 * SOUND_SAMPLEFLAG_EAGAIN flag is reset before each call to this 177 * SOUND_SAMPLEFLAG_EAGAIN flag is reset before each call to this
271 * 271 *
272 * Calling this with a NULL argument is a safe no-op. 272 * Calling this with a NULL argument is a safe no-op.
273 */ 273 */
274 void __Sound_SetError(const char *err); 274 void __Sound_SetError(const char *err);
275 275
276 /* !!! FIXME: Clean up elsewhere and get rid of this. */
277 #define Sound_SetError __Sound_SetError
278
279 /* 276 /*
280 * Call this to convert milliseconds to an actual byte position, based on 277 * Call this to convert milliseconds to an actual byte position, based on
281 * audio data characteristics. 278 * audio data characteristics.
282 */ 279 */
283 Uint32 __Sound_convertMsToBytePos(Sound_AudioInfo *info, Uint32 ms); 280 Uint32 __Sound_convertMsToBytePos(Sound_AudioInfo *info, Uint32 ms);