Miles Sound System SDK 7.2a

AIL_redbook_status

The function AIL_redbook_status returns the current status of the specified Red Book device.

U32 AIL_redbook_status(
  HREDBOOK hand
);

In Parameters

hand: specifies which CD device to query.

Returns

One of the MILES_REDBOOK_STATUS constants.

Discussion

This is the easiest way to determine if an audio CD is present.

Since an audio CD can be stopped by ejecting and or hitting a front panel button at any time, this function is usually called every couple of seconds to monitor the status of the audio system. Note that you can't call this function from a callback, so you'll have to check it in the foreground.

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_open, AIL_redbook_open_drive, AIL_redbook_open_volume, AIL_redbook_pause, AIL_redbook_play, AIL_redbook_resume, AIL_redbook_stop
Related Basic Types: HREDBOOK, MILES_REDBOOK_STATUS, U32