|Home > Target Connection Mechanism > Requirements for the target connection mechanism > CADISimulation|
CADISimulation class represents the connection to a simulated platform and provides information about platform targets that expose a CADI interface.
Querying this object returns a list with an element for each target. The descriptions include:
The caller uses the returned information to select a target.
To retrieve a pointer to the corresponding target, call the
of the CADISimulation. The returned pointer is to
the base class of the CADI interface.
As with other classes in the target connection mechanism,
Release() method to disconnect the caller
from a simulation. After
Release() is called, an
attached debugger must not address the simulation or a target previously
obtained from the simulation. Calling a released simulation might
raise an access violation because the connected target or simulation,
and the associated
CADI object, might already
be destroyed. The CADI simulation object owns all target interfaces
associated with the simulation and is therefore responsible for
their creation and destruction.
A major difference between the
CADISimulation and those of the other classes
true, the implementation for this method must manage shutting down the connected simulation. Shutdown includes informing other connected callers about the shutdown and waiting for them to acknowledge the request by calling
false, a simulation might be kept alive after disconnection. This might be the case if the debugger is one of multiple callers and there is no requirement to enforce a shutdown on disconnect.
CADIErrorCallback object are registered
CADISimulation through the corresponding
methods that established the connection. Dedicated methods are provided
to add additional callback objects to the simulation.