interface xdc.runtime.IInstance |
|
|
|
Common instance params
Every module's instance parameter structure contains a pointer to an
IInstance.Params structure named instance. So, every instance
parameter defined in this interface may optionally be set when
creating (or constructing) any module's instances.
interface IInstance { ...
instance: ...
interface IInstance {
instance:
per-instance config parameters
}
config IInstance.name // instance |
|
Name of the instance
config String name = null;
DETAILS
It is possible to "bind" a name to each instance of any module
at the time the instance is created (or constructed).
ModA_Params params;
ModA_Params_init(¶ms);
params.instance->name = "myInstance";
ModA_create(¶ms, NULL);
The name field must be assigned a pointer to a buffer that persists
as long as the instance that it names exists. Only a reference to
the name is retained in the instance, the name is not copied to a
secondary buffer.
If instances have been configured to not support names, it is still
possible to assign to the instance.name field of the parameter
structure (as shown above). However, the pointer is not retained
and methods that normally return an instance's name will return
NULL instead.
generated on Fri, 25 Jun 2010 22:40:33 GMT