OvisT_Anim_Reception_Init_Proc
Abstract
Callback: Invoked after the simulation kernel has created a reception object.
Syntax
<anim_reception_init_proc_name> (rcpt_ptr)
| Argument | Type | Description |
|---|---|---|
rcpt_ptr |
OvisT_Reception * |
Pointer to the reception object just created by the simulation kernel |
Return Type
void *
Pointer to a user state associated with the reception object.
Header
ovis_transmission_anim.h
Details
This callback is invoked when a reception object has been created by the simulation kernel. Such an object is created during “start transmission” simulation events before considering a specific receiver channel. A reception object is created for each transmission object associated with the event.
The callback is invoked before any pipeline stages related to that receiver channel.
This allows the creation of an appropriate user state structure to associate with the transmitter object.
The user state is returned by the function, and can be later accessed using Ovis_Reception_State_Get(). The user state can also be replaced later using Ovis_Reception_State_Set().