hwi_alloc_item()

Add an item structure to the system page hwinfo section.

Synopsis:

void *hwi_alloc_item(const char *tagname, 
                     unsigned size, 
                     unsigned align, 
                     const char *itemname, 
                     unsigned owner);

Arguments:

tagname: The name of the tag to add.
size: The size, in bytes, of the tag to allocate.
align: Ensure the structure is correctly aligned. If the structure contains any 64-bit integer fields, set align to 8; otherwise, set it to 4.
itemname: The name of the item to add.
owner: The item that owns this item (that is, the parent; see “Items”).

Description:

This function allocates an item structure. Its first three arguments are the same as in the hwi_alloc_tag() function. The itemname and owner arguments are used to set the itemname and owner fields of the hwi_item structure.

All hwi_alloc_tag() calls done after a hwi_alloc_item() call are assumed to belong to that item, and the itemsize field is adjusted accordingly.

Returns:

>0: Success: a pointer to a location in memory that can be filled in as appropriate.