NAME
        GetCardMap -- Obtain pointer to cardmemorymap structure

   SYNOPSIS
        pointer=GetCardMap()
        d0

        struct cardmemorymap *getcardmap( void );

   FUNCTION
        Obtain pointer to a cardmemorymap structure.  the structure
        is READ only.

        Devices should never assume credit-card memory appears
        at any particular place in memory.  By using this function
        to obtain pointers to the base memory locations of the various
        credit-card memory types, your device will continue to work
        properly should credit cards appear in different memory
        locations in future hardware.

   RETURNS
        Pointer to cardmemorymap structure -

                struct cardmemorymap {
                ubyte      *cmm_commonmemory;
                ubyte      *cmm_attributememory;
                ubyte      *cmm_iomemory;
                };

        As of card.resource V39, this structure has been extended to
        include the size of these memory regions.  See card.h/card.i
        for the new fields.  If card.resource V39, use the constants
        in the cardmemorymap structure rather than hard coded constants
        for memory region size.

   NOTES
        If any pointer in the structure is NULL, it means this type
        of credit-card memory is not being made available.

   SEE ALSO
        resources/card.h, resources/card.i