[Contents] [Index] [Help] [Retrace] [browse <] [Browse >]


NAME
    AllocateTagItems --  Allocate a tagitem array (or chain). (v36)

SYNOPSIS
    tagList = AllocateTagItems( numItems )
    D0                          D0

    struct tagitem *allocatetagitems( ulong numitems);

FUNCTION
    Allocates the specified number of usable TagItems slots, and does
    so in a format that the function freetagitems can handle.

    Note that to access the TagItems in 'tagList', you should use
    the function nexttagitem().  this will insure you respect any
    chaining (TAG_MORE) that the list uses, and will skip any
    TAG_IGNORE items that AllocateTagItems() might use to stash
    size and other information.

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

RESULT
    tagList         - the allocated chain of tagitem structures.  will
                      return NULL if unsuccessful.

BUGS

SEE ALSO
    freetagitems(), clonetagitems()