Removes data at the current position in the current message.

DWORD vceErase ( CTAHD ctahd,
unsigned msec,
unsigned *actual)

ctahd Handle returned by ctaCreateContext.

msec Amount of data to erase, in milliseconds.

actual Pointer to returned number of milliseconds erased.

• SUCCESS
• CTAERR_FUNCTION_ACTIVE
  Playing or recording is active on the CTA context.
• CTAERR_INVALID_CTAHD
• VCEERR_INVALID_OPERATION
  Either the current file type only supports erasing to the end of the message, or the current message is a list.
• VCEERR_NO_MESSAGE
  There is no current message in the CTA context.
• VCEERR_OUT_OF_INDICES
  The destination VOX file does not have any more free header entries.
• VCEERR_PLAY_ONLY
  The voice object containing the current message was not opened for record.

• None.

This function removes the specified number of milliseconds of data at the current position in the current message in the context specified by ctahd. It returns the number of milliseconds deleted in actual, unless actual is NULL.

The current position will be unchanged. The current message size will be reduced by the amount deleted.

You cannot erase while play or record is active.

If you attempt to erase beyond the end of the current message, SUCCESS will be returned and the current position will become the end of the message.

Erasing data to anywhere except the end of a message is allowed only on file types that fully support editing (currently only VOX files).

vceEraseMessage

/* Trim specified number of seconds off end of the current message */

void myTrim (CTAHD ctahd, unsigned seconds)
{
    unsigned msec = seconds*1000 ;

    vceSetPosition (ctahd, msec, VCE_SEEK_END, NULL) ;
    vceErase (ctahd, msec, NULL);
}