AIL_auto_service_stream

The function AIL_auto_service_stream turns auto-servicing on or off for a stream handle (it's turned on by default).

void AIL_auto_service_stream(
  HSTREAM stream,
  S32 onoff
);

In Parameters

stream

specifies which stream handle to control.

onoff

specifies whether to turn auto-servicing on (non-zero) or off (zero).

Discussion

Auto-servicing is available under Windows, Xbox, Wii, PS2 and MacOS - DOS applications must call AIL_service_stream manually.

Under Win32 and Win64, auto-streaming is accomplished with a secondary thread, so you don't need to call PeekMessage.

The only real reason you should ever have to turn off auto-streaming is if you want exact control of when file reading should take place.

Under DOS and MacOS 9, this function must not be invoked from an interrupt-based callback function.

Group: Digital Audio Streaming Services
Related Functions: AIL_open_stream, AIL_serve, AIL_service_stream
Related Basic Types: HSTREAM, S32, void

For technical support, e-mail Miles3@radgametools.com
© Copyright 1991-2007 RAD Game Tools, Inc. All Rights Reserved.