NAME
        GetPrefs -- Get the current Intuition preferences structure.

    SYNOPSIS
        Prefs = GetPrefs( PrefBuffer, Size )
        D0                A0          D0

        struct preferences *getprefs( struct preferences *, word );

    FUNCTION
        Gets a copy of the current Intuition preferences structure.
        Writes the data into the buffer you specify.  The number of bytes you
        want copied is specified by the size argument.

        It is legal to take a partial copy of the preferences structure.
        The more pertinent preferences variables have been grouped near
        the top of the structure to facilitate the memory conservation
        that can be had by taking a copy of only some of the preferences
        structure.

        New for V36:  A new and more extensible method for supplying
        preferences has been introduced in v36, and relies on file
        system notification.  The Intuition preferences items rely
        also on the IPrefs program.  Certain elements of the
        preferences structure have been superseded by this new method.
        As much as possible, the preferences structure returned by
        GetPrefs() reflect the current state of preferences.  however,
        it is impossible to represent some of the V36-style preferences
        items using the existing preferences structure.

    INPUTS
        PrefBuffer = pointer to the memory buffer to receive your copy of the
           Intuition preferences
        Size = the number of bytes in your PrefBuffer, the number of bytes
           you want copied from the system's internal Preference settings

    RESULT
        Returns your parameter PrefBuffer.

    BUGS

    SEE ALSO
        getdefprefs(), setprefs()