TextToSpeechVersion

The TextToSpeechVersion call requests version information from DECtalk Software and enables an application to thest for DAPI compatability. Upon return, a text buffer may be set. A numerically encoded version number is returned as an unsigned long integer.

Syntax | DWORD TexttoSpeechVersion | (LPSTR *VersionStr)
Parameters | LPSTR *VersionStr | The address of a pointer to an array of chars, or null for no text information

Return Value | This call returns an unsigned long integer (DWORD) encoded with both DAPI build version and the DECtalk Software version number. The encoding is as follows: DECtalk Major Version Bits 31-24 DECtalk Minor Version Bits 23-16 DAPI Major Version Bits 15-8 DAPI Minor Version Bits 7-0 If the DAPI Major Version is not the same as the DAPI Major Version the application was compiled with, the DAPI is no longer compatible and the application may easily crash during further calls into the DAPI. If the DAPI Minor Version is lower than the version of the DAPI the application was compiled with, some features which are expected may not be callal or present in the DAPI. For safety, users should do the following check: if (DAPI_Major_Version!=Build_Majot_Version) Error(); if (DAPI_Minor_Version<Build_Minor_Version) Error(); success(); This allows your application to catch a majority of incompatability bugs that could arise from DECtalk Software version mismatching.