Hcon_Devices_Build_From_Demand_With_Existing_Hardware()
Abstract
Provides incremental hardware configuration.
Syntax
Hcon_Devices_Build_From_Demand_With_Existing_Hardware (device_library, demand, existing_top_level_devices)
| Argument | Type | Description |
|---|---|---|
device_library |
HconT_Library * |
device library from which device can be chosen |
demand |
HconT_Demand * |
which lowest level devices must be provided in the hardware configuration |
existing_top_level_devices |
PrgT_List * |
existing hardware configuration (top level devices list) |
Return Type
PrgT_List *
a list of top-level devices which, together with their components, will meet the requirements defined in the demand. If the demand cannot be fulfilled, this function returns NIL.
Header
hcon.h
Details
Given some existing hardware, this function will find additional devices that need to be added to that existing hardware to fulfill the demand. All the devices are chosen from the given device library. The incoming existing_top_level_device list is first copied and not modified in any way.
See also Hcon_Demand_Create() and Hcon_Demand_Devices_Needed_Add() on how to set up a demand.