Carbon


CountVoices

Header: SpeechSynthesis.h Carbon status: Supported

Determines how many voices are available.

OSErr CountVoices (
    SInt16 *numVoices
);
Parameter descriptions
numVoices

On exit, a pointer to the number of voices that the application can use.

function result

A result code.

DISCUSSION

The CountVoices function returns, in the numVoices parameter, the number of voices available. The application can then use this information to call the GetIndVoice function to obtain voice specification structures for one or more of the voices.

Each time CountVoices is called, the Speech Manager searches for new voices.

SPECIAL CONSIDERATIONS

Because the CountVoices function moves memory, you should not call it at interrupt time.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)