The IMMAudioCDContents class is the class for an audio CD's table of contents. It allows you to keep a list of tracks. With this list you can rearrange the playback order of the tracks. For example, you could put track 5 at the first location, track 7 next, and then track 1.
You can construct, copy, and destruct objects of this class.
![]() |
public:
virtual ~IMMAudioCDContents()
Windows | OS/2 | AIX |
Yes | Yes | No |
![]() |
Use this function to create an IMMAudioCDContents.
public:
IMMAudioCDContents(const IMMAudioCDContents& newToc)
You cannot create your own table of contents without asking for one from the IMMAudioCD class.
Windows | OS/2 | AIX |
Yes | Yes | No |
protected:
IMMAudioCDContents( void* newContents, const IString& identifier, unsigned long tracks )
This function takes the following parameters:
Windows | OS/2 | AIX |
Yes | Yes | No |
protected:
IMMAudioCDContents()
This creates an invalid table of contents.
Windows | OS/2 | AIX |
Yes | Yes | No |
![]() |
public:
IMMAudioCDContents& operator =( const IMMAudioCDContents& newContents )
Sets the contents to be the same as another table of contents.
Windows | OS/2 | AIX |
Yes | Yes | No |
Use these members to add, remove, and replace the track numbers in the table of contents. For example, you want to listen to all of the CD except track 2 and you want to listen to track 5 played twice. To do this, you create a cursor on the table of contents. Then, you move the cursor to track 2 and call the remove entry function. Next, you move the cursor to track 5 and call the add entry function with 5 for the track number.
![]() |
public:
IMMAudioCDContents& addEntryAsFirst( unsigned long trackNumber )
Adds the track number to the beginning of the playback list.
Windows | OS/2 | AIX |
Yes | Yes | No |
![]() |
public:
IMMAudioCDContents& addEntryAsNext( unsigned long trackNumber, const Cursor& cursor )
Adds the track number after the cursor in the playback list.
Windows | OS/2 | AIX |
Yes | Yes | No |
![]() |
public:
unsigned long numberOfEntries() const
Returns the number of tracks in the playback list.
Windows | OS/2 | AIX |
Yes | Yes | No |
![]() |
public:
IMMAudioCDContents& removeEntryAt(const Cursor& cursor)
Removes the track number at the cursor from the playback list.
Windows | OS/2 | AIX |
Yes | Yes | No |
![]() |
public:
IMMAudioCDContents& replaceEntryAt( unsigned long newTrackNumber, const Cursor& cursor )
Replaces the track number at the cursor.
IInvalidParameter | The new track number can not be less than 1 or greater than the number of tracks. |
IInvalidParameter | The passed in cursor or this object is not valid. |
IInvalidRequest | An internal processing error occurred with the stored list of tracks. |
Windows | OS/2 | AIX |
Yes | Yes | No |
Use these members to query information about the entry at the given cursor for this table of contents.
![]() |
public:
unsigned long controlInformation( const Cursor& cursor ) const
Returns the track control information at the given cursor. This value cannot be set because it is set by the manufacturer of the CD.
Windows | OS/2 | AIX |
Yes | Yes | No |
![]() |
public:
unsigned long country(const Cursor& cursor) const
Returns the country at the given cursor. This value cannot be set because it is set by the manufacturer of the CD.
Windows | OS/2 | AIX |
Yes | Yes | No |
![]() |
public:
IString discId() const
Returns the compact disc identifier.
Windows | OS/2 | AIX |
Yes | Yes | No |
![]() |
public:
IMMTime endOfTrack(const Cursor& cursor) const
Returns the ending time (position) of the track.
Windows | OS/2 | AIX |
Yes | Yes | No |
![]() |
public:
bool isValid() const
Returns true if the table of contents is valid.
Windows | OS/2 | AIX |
Yes | Yes | No |
![]() |
public:
unsigned long numberOfTracks() const
Returns the number of tracks.
Windows | OS/2 | AIX |
Yes | Yes | No |
![]() |
public:
unsigned long owner(const Cursor& cursor) const
Returns the owner of the track at the given cursor. This value cannot be set because it is set by the manufacturer of the CD.
Windows | OS/2 | AIX |
Yes | Yes | No |
![]() |
public:
unsigned long serialNumber(const Cursor& cursor) const
Returns the serial number of the track at the given cursor. This value cannot be set because it is set by the manufacturer of the CD.
Windows | OS/2 | AIX |
Yes | Yes | No |
![]() |
public:
IMMTime startOfTrack(const Cursor& cursor) const
Returns the starting time (position) of the track.
Windows | OS/2 | AIX |
Yes | Yes | No |
![]() |
public:
unsigned long track(const Cursor& cursor) const
Returns the track number at the given cursor.
Windows | OS/2 | AIX |
Yes | Yes | No |