| Allegro CL version 6.2 Unrevised from 6.1 |
Arguments: nil
This function combines the information returned by the functions file-systems, file-system-type, and file-system-info into a single list.
Each member of the returned list is itself a list that describes one file system. This sublist is a plist where the first key/value pair is :name with the the name of the file-system (as returned by file-systems), followed by :type with the value returned by file-system-type, followed by the plist values returned by file-system-info. The Tools | Inspect System Data | Online File Systems command inspects the list returned by this function.
Note that a drive for which file-system-info returns nil
has an entry in the list returned by file-systems-info even
though they are not ready for use. Thus, if G is the CD drive, and
there is no CD inserted, file-system-info returns nil
but (:NAME "G:" :TYPE :CDROM)
is in the list returned by file-systems-info. Similarly, if A
is the floppy drive and no floppy is inserted, file-system-info returns nil
and (:NAME "A:" :TYPE
:REMOVABLE)
is in the list returned by file-systems-info. Therefore, if
you are interested in whether a drive is ready, you may want to apply
file-system-info
to its name after discovering its name from file-systems-info. (In fact,
analysis of the whole list retyurned by file-systems-info can tell you
whether the drive is ready -- ready drives typically have volume names
and other attributes not appearing in the list of an unready drive.)
MSDN (MicroSoft Developer Network) information suggests that is it possible that a call to file-systems-info will not complete if a CD drive or a floppy drive (or such) is not ready, as the system will display a modal dialog saying the drive is not ready when it tries to get information about the drive. In practice, this does not seem to happen (it has never been reported), but wrapping the call to file-systems-info as follows will guarantee that it will not happen.
(let* (former-error-mode) (unwind-protect (progn (setq former-error-mode (win:SetErrorMode 1)) (win:file-systems-info)) (when former-error-mode (win:SetErrorMode former-error-mode))))
The home package of the symbol naming this function is
windows
but for backward compatibility, it is also
exported from the common-graphics
package. Therefore, this function is available even in images into
which the :winapi
module has been loaded but the
Common Graphics and IDE modules have not.
Copyright (c) 1998-2002, Franz Inc. Oakland, CA., USA. All rights reserved.
Documentation for Allegro CL version 6.2. This page was not revised from the 6.1 page.
Created 2002.2.26.
| Allegro CL version 6.2 Unrevised from 6.1 |