VMS Help RTL Routines, DTK$, DTK$SPEAK_FILE  *Conan The Librarian (sorry for the slow response - running on an old VAX)

   The Speak the Text in a  Specified  File  routine  speaks  the  text
   contained in the specified file.

      Format:

        DTK$SPEAK_FILE  voice-id ,filespec [,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.

   filespec

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

   File specification of the file containing the  text  to  be  spoken.
   The  filespec  argument  is  the address of a descriptor pointing to
   this file.

   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.