NAME
irRecordResume - resume voice record
SYNOPSIS
#include <irapi.h>
int irRecordResume (channel_id cid, int offset);
DESCRIPTION
The irRecordResume function may be used to restart a remem-
bered play or record request from the point it was inter-
rupted, relative to offset. See irEnd(3IRAPI) and
irRecord(3IRAPI) for information on how to remember a play
or record request. offset is specified in milliseconds.
irRecordResume may only be called from the IRS_IDLE state.
Also, irRecordResume may only be called on a remembered play
request if the play request included a single voice file or
voice file descriptor; it is not possible to record over a
remembered multi-voice file or buffer play request.
EVENT
The IRE_RECORD_DONE event occurs when record completes.
RETURN VALUE
IRR_OK is returned if the request to resume record is suc-
cessfully initiated.
IRR_PENDING is returned if resources could not be allocated
and IRP_RESOURCE_RETURNMODE is not set to IRD_IMMEDIATE.
IRR_FAIL is returned if an error occurs.
ERROR
irError is set as follows if an error occurs:
IRER_INVALID if the cid is not valid or if the cid has not
remembered any play or record request. IRER_INVALID is also
set if irRecordResume(3IRAPI) is called on a remembered play
request containing multiple voice file or voice file
descriptors or both or if the remembered play activity con-
tains a buffer play.
IRER_BADSTATE if the cid is in any state other than IRS_IDLE
IRER_SYSERROR if a system or driver call failure occurs
(check irSysError for additional information)
IRER_RTU_BUSY if the required Feature License's are all in
use and IRP_RESOURCE_RETURNMODE is set to IRD_IMMEDIATE
IRER_NO_RTU if no Feature License has been purchased for
this function
IRER_RESOURCEBUSY if no resources available and
IRP_RESOURCE_RETURNMODE is set to IRD_IMMEDIATE
IRER_NORESOURCES if no resources in exist.
IRER_RESTRICTED if the channel is restricted from using the
required resources
SEE ALSO
irEnd(3IRAPI)and irRecord(3IRAPI).
VERSION
This is version 8/31/00 of this man page.