/sys$common/syshlp/helplib.hlb RTL Routines, DTK$, DTK$SPEAK_TEXT  *Conan The Librarian (sorry for the slow response - running on an old VAX)

   The Speak the Specified Text routine sends the specified text to the
   DECtalk device to be spoken.

      Format:

        DTK$SPEAK_TEXT  voice-id ,text [,completion-mode]

      Arguments:

   voice-id

   OpenVMS usage: identifier
   type:          longword (unsigned)
   access:        read only
   mechanism:     by reference

   Voice identifier of the DECtalk device.  The  voice-id  argument  is
   the address of an unsigned longword containing this identifier.  The
   voice identifier is returned by the DTK$INITIALIZE routine.

   text

   OpenVMS usage: char_string
   type:          character string
   access:        read only
   mechanism:     by descriptor

   Text to be spoken.  The text argument is the address of a descriptor
   pointing to the specified text.

   completion-mode

   OpenVMS usage: longword_unsigned
   type:          longword (unsigned)
   access:        read only
   mechanism:     by reference

   Mode characteristic.  The optional completion-mode argument  is  the
   address  of  an  unsigned  longword  containing  the specified mode.
   Valid values for the completion-mode argument are:

        DTK$K_IMMED          Return to the user immediately (default).

        DTK$K_WAIT           Wait until the text is completely spoken.

        DTK$K_STATUS         Wait until the text is completely  spoken,
                               and then return a phone status.