NAME
irGetVCount - returns the voice stream count after an event
SYNOPSIS
#include <irapi.h>
long irGetVCount (channel_id cid);
DESCRIPTION
The irGetVCount function returns the amount of time played
or recorded when an IRE_PLAY_DONE, an IRE_PLAY_PROG or an
IRE_RECORD_DONE event occurs for the channel indicated by
cid.
It returns the number of bytes of TTS played after an
IRE_SAY_DONE or IRE_SAY_PROG event.
It returns the number of bytes of FAX data recorded when an
IRE_FAX_DONE event occurs.
Time is accumulated from the most recent irEnd(3IRAPI),
irRecord(3IRAPI), irPlayResume(3IRAPI) or
irRecordResume(3IRAPI).
EVENT
No event results from the call to irGetVCount.
RETURN VALUE
The time/space value in milliseconds/bytes is returned if
the request is successful.
IRR_FAIL is returned if an error occurs.
ERROR
irError is set to IRER_INVALID if the cid is invalid.
EXAMPLE
The count is the amount of time played from the starting
point to the point of interruption or to the end of the
voice file. This is not the same as position, which is the
starting point plus the time played or recorded.
A typical calling sequence is
irPlay( cid, 1, file, 0 );
irEnd( cid, 0 );
irWait( ); /* block until event */
event_id = irCheck( event ); /* get event */
if( event_id == IRE_PLAY_DONE && event->cid == cid ) {
time_played = irGetVCount( event->cid )
}
SEE ALSO
irLSeek(3IRAPI), irByte2Time(3IRAPI), irTime2Byte(3IRAPI)
VERSION
This is version 8/31/00 of this man page.