osa_component osa_control_v2
API Reference Manual  /  7 Simulator-to-Simulator Interfaces  / 

osa_control

Description

request is used to register clients that are interested in using the tracker framework and activates the tracker framework if it is not already activated. The initiator argument is a string which should describe the client that requests to activate the OS Awareness framework. The return value is an ID that should be passed to the release function to signal that the client no longer needs the OS Awareness framework.

Upon a failure while initializing the OS Awareness framework, OSA_Request_Error_ID will be returned.

release removes a client that has previously requested to use the tracker framework. The id argument is the returned value from request. The tracker framework will be disabled when there are no more registered users.

SIM_INTERFACE(osa_control) {
        request_id_t (*request)(conf_object_t *NOTNULL obj,
                                const char *initiator);
        void (*release)(conf_object_t *NOTNULL obj, request_id_t id);
};

#define OSA_CONTROL_INTERFACE "osa_control"

Execution Context
Global Context for all methods.

osa_component osa_control_v2