Hcon_Library_Nth_Level_DCR_File_Load()
Abstract
Populates one level of a device library by loading the Device Containment Relationship (DCR) file for that level.
Syntax
Hcon_Library_Nth_Level_DCR_File_Load (library, file_name, level)
| Argument | Type | Description |
|---|---|---|
library |
HconT_Library * |
the device library into which to load devices |
file_name |
char * |
full path of the DCR file |
level |
int |
level number of the devices in the DCR hierarchy |
Return Type
void
no return value
Header
hcon.h
Details
By reading in a DCR file, defines what devices are available for a device library at one specific level. It also defines what kind and how many of lower-level devices these devices may contain.
This function must be called successively with the level arguments in ascending order, starting with 1.
The loading is additive, not overriding. This means that if you call this function twice with the same level number but two different DCR files, devices from the second DCR file will be added to the library, which will still contain the devices loaded from the first DCR file.