[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()