(Page 19 of 40 in this chapter)

vceGetUniqueMessageNumber

Description

Gets the lowest unused message number in an open voice object.

Prototype

DWORD vceGetUniqueMessageNumber ( VCEHD vh,
 unsigned *message)

vh Handle of an open voice object.

message Pointer to a returned message number or VCE_UNDEFINED_MESSAGE.

Return Values

Events

Details

This function can be used to get a message number before recording a new message. It returns the lowest empty (0-length) message in the open voice object. If the order of the messages must be maintained, use vceGetHighMessageNumber instead.

The returned message number will be VCE_UNDEFINED_MESSAGE if there are no unused message numbers in the voice object.

vceGetUniqueMessageNumber does not affect the current message.

See Also

vceGetHighMessageNumber, vceGetMessageSize

Example


/* Start recording a new message */

void myAddMessage (VCEHD vh, unsigned *message)
{
    vceGetUniqueMessageNumber (vh, message) ;
    vceRecordMessage (vh, *message, VCE_NO_TIME_LIMIT, NULL) ;
}

(Page 19 of 40 in this chapter)

tech_support@nmss.com
Copyright © 1999, Natural MicroSystems, Inc. All rights reserved.