oms_aa_address_resolve()
Abstract
Creates a new, unique address (if the address is auto-assigned) or verifies that the address is unique (if the address is explicitly assigned).
Syntax
oms_aa_address_resolve (oms_aa_handle, module_id, address_ptr)
| Argument | Type | Description |
|---|---|---|
oms_aa_handle |
OmsT_Aa_Address_Handle |
Handle to the list for the specific address type |
module_id |
Objid |
Object ID of the module registering the address |
address_ptr |
int * |
Pointer to the address to be resolved [This can be an explicitly assigned address or OMSC_AA_AUTO_ASSIGN.] |
Return Type
void
No return value
Details
This procedure resolves address assignments by verifying that each network address of a specific type is unique.
If the number referenced by address_ptr equals OMSC_AA_AUTO_ASSIGN, the procedure creates a new address and registers it in the address list.
If the number referenced by address_ptr is an explicitly assigned address, this procedure searches the address list to see if the address is already registered. If it finds an auto-assigned address set to the same value, it assigns a new unique value to this address. If it finds an explicitly assigned address set to the same value—i.e., if it finds that two nodes are explicitly assigned the same address—the simulation terminates with an error message.
Example
From 11m_mac process model, function block, llm_mac_layer_addressing_init() function:
/** Registers the specified MAC address in a model **/
/** wide address registry to ensure unique address. **/
FIN (llm_mac_layer_addressing_init ());
/* Get assigned value for mac address. */
op_ima_obj_attr_get (own_id, "station_address",&my_address);
/* Resolve this address using the global address pool.*/
oms_aa_address_resolve (oms_aa_handle, own_id, &my_address);