Miles Sound System SDK 7.2a

AIL_redbook_play

The function AIL_redbook_play begins playback of an audio CD at the specified offset.

U32 AIL_redbook_play(
  HREDBOOK hand,
  U32 start_ms,
  U32 end_ms
);

In Parameters

hand: specifies which CD device to play.
start_ms: specifies the starting millisecond to play.
end_ms: specifies the ending millisecond to play.

Returns

The current playback status - see AIL_redbook_status for the possible return values.

Discussion

Playback will automatically end when the end offset is reached.

You will usually call the AIL_redbook_track_info function to get the start and end offsets of the track that you want to play - but that isn't required. You could, for example, play the last two seconds of track 5 and the first three seconds of track 6.

Track 1 does not usually start at a millisecond offset of zero - always use AIL_redbook_track_info to get starting offsets.

You can monitor the playback with AIL_redbook_status and AIL_redbook_position.

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

Example files that use this function: Demo.C, AudioCD.C

Group: CD Audio (Redbook) Services
Related Functions: AIL_redbook_pause, AIL_redbook_position, AIL_redbook_resume, AIL_redbook_status, AIL_redbook_stop, AIL_redbook_track_info
Related Basic Types: HREDBOOK, U32
Related FAQs: How do I loop a track off a CD?, How do I play a track off a CD?