COM Objects > TagsReader object > Methods > TagsReader.WAV

Remarks

Obtains a time marker field of the CART chunk.

For further details about methods related to tags reading refer to the TagsReader object.

For details about the reading of tags see the How to read TAG information in sound files tutorial.

Syntax

[Visual Basic]

control.TagsReader.WAV_CartChunkTimeMarkerFieldGet (

nFieldId as enumCartChunkTimeMarkerField,

nPositionInSamples as Long

) as String

[C++]

BSTR control.TagsReader.WAV_CartChunkTimeMarkerFieldGet (

short nFieldId,

long *nPositionInSamples

);

Parameter

Description

nFieldId

Identifier of the field to get.

Supported values are the following:

Mnemonic Value	Value	Meaning
WAV_CART_CHUNK_TIME_MARKER1	0	Time marker 1
WAV_CART_CHUNK_TIME_MARKER2	1	Time marker 2
WAV_CART_CHUNK_TIME_MARKER3	2	Time marker 3
WAV_CART_CHUNK_TIME_MARKER4	3	Time marker 4
WAV_CART_CHUNK_TIME_MARKER5	4	Time marker 5
WAV_CART_CHUNK_TIME_MARKER6	5	Time marker 6
WAV_CART_CHUNK_TIME_MARKER7	6	Time marker 7
WAV_CART_CHUNK_TIME_MARKER8	7	Time marker 8

nPositionInSamples

Reference that, on return from the method call, will contain the time marker position expressed in samples.

Return value

Value

Meaning

Empty string

The information is not available or an error occurred (see the LastError property for further error details)

Valid string

String of 4 characters (also known as FOURCC) containing the identifier of the time marker.

The following table summarizes the basic timer types:

Timer ID	Description	Start-End	Enumerated	Multiples
XXX (*)	Custom timer	No	No	Yes
SEGx (**)	Segue timer	Yes	Yes	Yes
AUDx (**)	Audio boundary	Yes	No	No
INTx (**)	Introduction	Yes	Yes	Yes
OUTx (**)	Epilog	Yes	Yes	Yes
SECx (**)	Secondary	Yes	Yes	Yes
TERx (**)	Tertiary	Yes	Yes	Yes
MRKx (**)	Generic marker	No	Yes	Yes
EODx (**)	End-of-data	No	No	Yes

(*) You can define your own timer ID by replacing the XXX with other ASCII characters.

(**) Timers may be qualified in one of following ways:

as start or end timers, by replacing the "x" character with a lower case ASCII letter "s" for a start timer or a lower case ASCII letter "e" for an end timer; for example, the timer identification AUDs designates the start of audio following silence, while AUDe designates the end of the audio segment.

2.	as enumerated timers, by replacing the "x" character with an ASCII numeric character; for example, SEC1 may be designated secondary timer number 1, SEC2 may be secondary number 2, and so on

3.	as multiple timers, by having multiple instances of the same timer ID; one may have, for example, multiple instances of MRK. Custom timers belong in this category.