NAME
        AllocateTagItems -- allocate a tag list. (V36)

   SYNOPSIS
        tagList = AllocateTagItems(numTags);
        D0                         D0

        struct tagitem *allocatetagitems(ulong);

   FUNCTION
        Allocates the specified number of usable TagItems slots.

        Note that to access the TagItems in 'tagList', you should use
        the function nexttagitem(). this will insure you respect any
        chaining (TAG_MORE) and secret hiding places (TAG_IGNORE) that
        this function might generate.

   INPUTS
        numTags - the number of tagitem slots you want to allocate.

   RESULTS
        tagList - the allocated chain of tagitem structures, or null if
                  there was not enough memory. An allocated tag list must
                  eventually be freed using freetagitems().

   SEE ALSO
        <utility/tagitem.h>, freetagitems(), clonetagitems()