Table of Contents Index NMS Glossary Previous Page Next Page (Page 18 of 41 in this chapter) Version


vceGetMessageSize

Description

Gets the size (in milliseconds) of the specified message.

Prototype

DWORD vceGetMessageSize ( VCEHD vh,
unsigned
message,
unsigned
*msgsize)

vh Handle of an open voice object.
message Message number.
msgsize Pointer to a returned message size (in
milliseconds).

Return Values

Events

Details

This function returns the size (in milliseconds) of the voice message specified by voice handle vh and message number message.

vceGetMessageSize will return SUCCESS for any message number that is valid for the file type of vh. Otherwise, the return code will be VCEERR_INVALID_MESSAGE.

To convert the size into bytes, get the encoding format with vceGetOpenInfo, and get the frame size and frame duration with vceGetEncodingInfo. Convert using the following formula:

bytes = (milliseconds / frame time ) * frame size

To get the total size of all messages in a voice object, use VCE_ALL_MESSAGES as the message number.

To get the size of the current message, use vceGetCurrentSize.

Note: vceGetMessageSize does not affect the current message.

See Also

vceGetCurrentSize, vceGetEncodingInfo, vceGetOpenInfo

Example

Refer to vceGetHighMessageNumber.



Table of Contents Index NMS Glossary Previous Page Next Page (Page 18 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.