Hiva::CreateWallTimer

wallPeriod

Input

Period for triggering the callback function. The value is of the standard Duration type for the framework.

wallCallback

Input

Callback function after the timer expires. The type is WallTimerCallback. WallTimerEvent is as follows:

using WallTimerCallback = std::function<void (const WallTimerEvent &)>;

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

struct WallTimerEvent
{
    Hiva::WallTime last_expected;    // Time when the last callback should occur
    Hiva::WallTime last_real;        // Actual time when the last callback occurs
    Hiva::WallTime last_expired;     // Time when the last timer expires on the timer server and a notification is sent to the application
    Hiva::WallTime current_expected; // Time when the current callback should occur
    Hiva::WallTime current_real;     // Actual time when the current callback occurs
    Hiva::WallTime current_expired;  // Time when the current timer expires on the timer server and a notification is sent to the application
    struct{
    Hiva::WallDuration last_duration; // Last callback execution duration
    } profile;
};

wallGroupName

Input

Thread group created when OpenHiva::Init is invoked. For a deterministic group, the deterministic scheduling framework is used. For other groups, the OS scheduling framework is used.

oneshot

Input

Mode flag.

• true indicates that the one-off oneshot mode is used and the timer is triggered only once.
• false indicates that the periodic mode is used. The timer is triggered periodically until the process resources are cleared.

autostart

Input

Start flag.

• true indicates that the timer is automatically started. When the interface returns a value, the timer is started.
• false indicates that the timer is not automatically started. When the interface returns a value, the timer is not started and needs to be manually started through Hiva::WallTimer::Start.