(Page 29 of 41 in this chapter) Version
vceReadMessageText
Description
- Reads the message text for a specified voice message in a VOX file.
Prototype
- DWORD vceReadMessageText ( VCEHD vh,
unsigned message,
void *buffer,
unsigned bytes,
unsigned *bytesread)
- vh Handle of an open VOX file.
- message Any valid VOX file message number.
- buffer Pointer to a buffer to receive data.
- bytes Size of buffer.
- bytesread Pointer to the returned number of bytes read.
Return Values
Events
Details
- This function reads auxiliary data for a specified message in a VOX file. Although the function name suggests that this function is used for textual data, the data can be any binary data.
See Also
- vceCopyMessageText
, vceWriteMessageText
Example
/* Displays descriptive text for a message in an open VOX file. */
void myReadMessageText (VCEHD vh, unsigned message)
{
char buf[80];
unsigned bytesread;
if (vceReadMessageText (vh, message, buf, sizeof buf-1, &bytesread)
== SUCCESS
{
/* Ensure the buffer is null-terminated. */
buf[bytesread] = `\0';
printf ("[%] %s\n", message, buf);
}
}
(Page 29 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.