NAME
          irSPDDeleteDisk, irSPDFreeDisk, irSPDReportDisk irSPDReser-
          veDisk - return, free, report and reserve disk space managed
          by the Speech Disk Manager

     SYNOPSIS
          #include <irapi.h>

          int irSPDDeleteDisk (const char *fs_name, long
          delete_bytes);

          int irSPDFreeDisk (const char *fs_name, long free_bytes,
          long used_bytes);

          int irSPDReportDisk (int tag);

          int irSPDReserveDisk (const char *fs_name, long
          reserve_bytes, long tag);


     DESCRIPTION
          The irSPD functions provide services for disk space manage-
          ment.  fs_name is the name of the file system for which the
          operation is intended.

          irSPDDeleteDisk is used to indicate to the disk space
          manager that an application has deleted a file, thereby
          freeing up the space.  delete_bytes is the number of bytes
          in the deleted file.

          irSPDFreeDisk indicates an application has completed the
          recording of a voice file and is returning any space that
          had been reserved but not used.  For example, the applica-
          tion would reserve, using irSPDReserveDisk, the maximum
          amount of space for a message.  The message may be shorter
          than the maximum; the space not used is returned via
          irSPDFreeDisk.  free_bytes is the number of bytes not used
          in the voice file, used_bytes is the number of bytes used.

          irSPDReportDisk initiates a query on available and total
          purchased speech disk space.  The results of the query are
          returned through a subsequent IRE_REPORT_DISK event.

          irSPDReserveDisk attempts to allocate reserve_bytes bytes of
          disk space from file system fs_name.  If fs_name is the NULL
          pointer, the file system having the greatest available space
          will be chosen.  Results of the allocation attempt are
          reported through the IRE_RESERVE_DISK event.

     EVENT
          The function irSPDReportDisk, generates the event
          IRE_REPORT_DISK, the function irSPDReserveDisk, generates
          the event IRE_RESERVE_DISK.

     RETURN VALUE
          All functions return IRR_OK on success and IRR_FAIL on
          error.

     ERROR
          irError is set as follows if an error occurs:

          IRER_INVALID if fs_name is the NULL pointer for
          irSPDDeleteDisk or irSPDFreeDisk.

          IRER_INVALID if delete_bytes,used_bytes,free_bytes or
          reserve_bytes is negative.

          IRER_NOTFOUND if the spDskMgr process has not been started.

          IRER_SYSERROR if a system or driver call failure occurs
          (check irSysError for additional information)

     SEE ALSO
          irPhReserve(3IRAPI), IrEVENTS(4IRAPI)

     VERSION
          This is version 11/25/02 of this man page.