Получение и изменение значений времени (time_api.h)

21 мая 2024

ID libkos_time_api

API определен в заголовочном файле sysroot-*-kos/include/coresrv/time/time_api.h из состава KasperskyOS SDK.

Основные возможности API:

  • получать и изменять системное время;
  • получать монотонное время, отсчитанное с момента запуска ядра KasperskyOS;
  • получать разрешение источников системного и монотонного времени.

Сведения о функциях API приведены в таблице ниже.

Функции time_api.h

Функция

Сведения о функции

KnGetSystemTimeRes()

Назначение

Позволяет получить разрешение источника системного времени.

Параметры

  • [out] res – указатель на структуру, содержащую в поле nsec разрешение источника системного времени в наносекундах. Тип структуры определен в заголовочном файле sysroot-*-kos/include/rtl/rtc.h из состава KasperskyOS SDK.

Возвращаемые значения

В случае успеха возвращает rcOk, иначе возвращает код ошибки.

KnSetSystemTime()

Назначение

Задает системное время.

Параметры

  • [in] time – указатель на структуру, содержащую следующие сведения: в поле sec – число секунд, прошедших с 1 января 1970 года; в поле nsec – число наносекунд, прошедших с момента, заданного в поле sec. Тип структуры определен в заголовочном файле sysroot-*-kos/include/rtl/rtc.h из состава KasperskyOS SDK.

Возвращаемые значения

В случае успеха возвращает rcOk, иначе возвращает код ошибки.

KnGetSystemTime()

Назначение

Позволяет получить системное время.

Параметры

  • [out] time – указатель на структуру, содержащую следующие сведения: в поле sec – число секунд, прошедших с 1 января 1970 года; в поле nsec – число наносекунд, прошедших с момента, заданного в поле sec. Тип структуры определен в заголовочном файле sysroot-*-kos/include/rtl/rtc.h из состава KasperskyOS SDK.

Возвращаемые значения

В случае успеха возвращает rcOk, иначе возвращает код ошибки.

KnGetUpTimeRes()

Назначение

Позволяет получить разрешение источника монотонного времени, отсчитываемого с момента запуска ядра KasperskyOS.

Параметры

  • [out] res – указатель на структуру, содержащую в поле nsec разрешение источника монотонного времени, отсчитываемого с момента запуска ядра KasperskyOS, в наносекундах. Тип структуры определен в заголовочном файле sysroot-*-kos/include/rtl/rtc.h из состава KasperskyOS SDK.

Возвращаемые значения

В случае успеха возвращает rcOk, иначе возвращает код ошибки.

KnGetUpTime()

Назначение

Позволяет получить монотонное время, отсчитанное с момента запуска ядра KasperskyOS.

Параметры

  • [out] time – указатель на структуру, содержащую следующие сведения: в поле sec – число секунд, прошедших с момента запуска ядра KasperskyOS; в поле nsec – число наносекунд, прошедших с момента, заданного в поле sec. Тип структуры определен в заголовочном файле sysroot-*-kos/include/rtl/rtc.h из состава KasperskyOS SDK.

Возвращаемые значения

В случае успеха возвращает rcOk, иначе возвращает код ошибки.

KnGetRtcTime()

Назначение

Позволяет получить системное время.

Параметры

  • [out] rt – указатель на структуру, содержащую следующие сведения о времени: год, месяц, день, часы, минуты, секунды, миллисекунды. Тип структуры определен в заголовочном файле sysroot-*-kos/include/rtl/rtc.h из состава KasperskyOS SDK.

Возвращаемые значения

В случае успеха возвращает rcOk, иначе возвращает код ошибки.

KnGetMSecSinceStart()

Назначение

Позволяет получить монотонное время, отсчитанное с момента запуска ядра KasperskyOS.

Параметры

Нет.

Возвращаемые значения

Монотонное время, отсчитанное с момента запуска ядра KasperskyOS, в миллисекундах.

KnAdjSystemTime()

Назначение

Запускает постепенную корректировку системного времени.

Параметры

  • [in] adj – указатель на структуру, содержащую интервал времени, на который нужно скорректировать системное время (sec*10^9+nsec наносекунд) или RTL_NULL, если не требуется запускать корректировку, а нужно только получить сведения о ранее запущенной корректировке (через параметр prev). Тип структуры определен в заголовочном файле sysroot-*-kos/include/rtl/rtc.h из состава KasperskyOS SDK.
  • [in] slew – скорость корректировки системного времени (микросекунд в секунду).
  • [out] prev – указатель на структуру, содержащую интервал времени, отражающий, на какое значение оставалось (или остается в случае указания RTL_NULL в параметре adj) скорректировать системное время, чтобы уже запущенная постепенная корректировка была полностью завершена (sec*10^9+nsec наносекунд). Тип структуры определен в заголовочном файле sysroot-*-kos/include/rtl/rtc.h из состава KasperskyOS SDK.

Возвращаемые значения

В случае успеха возвращает rcOk, иначе возвращает код ошибки.

Дополнительные сведения

Если запустить новую корректировку до завершения ранее запущенной, то ранее запущенная будет прервана.

Вам помогла эта статья?
Что нам нужно улучшить?
Спасибо за ваш отзыв, вы помогаете нам становиться лучше!
Спасибо за ваш отзыв, вы помогаете нам становиться лучше!