(Page 20 of 41 in this chapter) Version
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 20 of 41 in this chapter) Version
Want to send us feedback on our documentation? Email: Tech_Pubs@nmss.com
Copyright © 2001, Natural MicroSystems, Inc. All rights
reserved.