When a task uses a system- supplied item such as a device or a folio, it opens the item instead of creating it. To open an item, use these calls:
Item OpenItem( Item FoundItem, void *args ) Item FindAndOpenItem( int32 cType, const TagArg *tags) Item FindAndOpenItemVA( int32 cType, uint32 tags, ...)
OpenItem()
accepts the item number of the resource to be opened (which is found with FindItem()
) and a pointer. Currently, NULL should always be passed in for this argument.
FindAndOpenItem()
finds an item and opens it with one call. It works just like FindItem()
, except that it automatically opens the item before returning it to you.