Development Tools User’s Guide
267
Intel
®
IXP2400/IXP2800 Network Processors
Simulator APIs
9.4.9
XACT_Define_Cancel_Callback_State_Transition
Define the callback to cancel any further state transition callbacks when the specified state
changes. NOTE: this callback must be defined prior to calling
XACT_Define_Callback_State_Transition()
above. This callback will be called if
the transactor deletes the state associated with the HANDLE. State deletion can occur if the state
element was a user-defined state (e.g. C variable, function, watch, etc.). A predefined hardware
state element will never be deleted, but for consistency, this cancel callback is still required to be
specified prior to defining a state transition callback. This routine returns 1 if successful, 0
otherwise
Synopsis
XACTAPI
XACT_Define_Cancel_Callback_State_Transition(
XACT_HANDLE state,int (*fp)( XACT_HANDLE handle,
void *user_data)
)
9.4.10
XACT_Cancel_State_Transition_Callback
Calling this routine allows the caller to explicitly cancel the predefined state transition callback. It
returns 1 if successful, -1 if no callback was associated with this state or 0 otherwise
Synopsis
XACTAPI XACT_Cancel_State_Transition_Callback(
XACT_HANDLE state
)
9.4.11
XACT_Define_Handle_Invalidation_Callback
This function allows the user to be notified when a handle is about to become invalidated. Handle
invalidations can occur when the user has acquired a handle to a temporary state (e.g. C variable,
function, watch, etc.). The handle is valid when the specified callback is called and becomes
invalid as soon as execution returns from the callback. This routine returns 1 if successful; 0
otherwise.
Synopsis
XACTAPI
XACT_Define_Handle_Invalidation_Callback( int
(*fp)( XACT_HANDLE handle ) )
9.4.12
XACT_Define_Callback_Output_Message
Passes transactor output strings to callback function. Note that the transactor will still print the
string to its own console output regardless of this callback.
Synopsis
XACTAPI XACT_Define_Callback_Output_Message(
void(*fp)(OUTPUT_MSG_SEVERITY severity, const
char *message) )
9.4.13
XACT_Define_Callback_Set_Prompt
This function registers the callback to pass the transactor prompt to an external command line. It
must be called after the transactor has been initialized. It returns TRUE if successful, and FALSE
otherwise.
