(Page 28 of 40 in this chapter)

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 28 of 40 in this chapter)

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