(Page 15 of 41 in this chapter) Version
vceGetCurrentSize
Description
- Gets the size of the current message.
Prototype
- DWORD vceGetCurrentSize ( CTAHD ctahd,
unsigned *actualsize)
- ctahd Handle returned by ctaCreateContext.
- actualsize Pointer to the returned size, in milliseconds, of the current message.
Return Values
Events
Details
- This function retrieves the size of the current message for the context specified by ctahd. The size is in milliseconds.
- If the current message is a list, this function returns the total size of all messages in the list.
- Use vceGetContextInfo to get the current position in the current message.
See Also
- vceGetContextInfo
Example
/* delete current message if smaller than threshold */
extern CTAHD Ctahd;
void myDeleteSmallMessage (unsigned minseconds)
{
unsigned actualsize; /* size in milliseconds */
vceGetCurrentSize (Ctahd, &actualsize) ;
if (actualsize < minseconds * 1000)
{
/* Use vceErase to erase the current message */
vceSetPosition (Ctahd, 0, VCE_SEEK_SET, NULL) ;
vceErase (Ctahd, actualsize, NULL);
}
}
(Page 15 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.