KasperskyOS Community Edition 1.3

Служба взаимодействия со встроенным программным обеспечением аппаратной платформы

Служба предназначена для взаимодействия со встроенным программным обеспечением (англ. firmware) аппаратной платформы через интерфейс EFI.

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

Методы службы efi.Efi (интерфейс kl.core.Efi)

Метод

Назначение и параметры метода

Потенциальная опасность метода

GetTime

Назначение

Позволяет получить текущее время от источника времени на аппаратной платформе и характеристики этого источника.

Параметры

  • [out] time – структура, содержащая сведения о времени.
  • [out] capabilities – структура, содержащая характеристики источника времени.
  • [out] rc – код возврата.

Нет.

SetTime

Назначение

Устанавливает текущее время в источнике времени на аппаратной платформе.

Параметры

  • [in] time – структура, содержащая сведения о времени.
  • [out] rc – код возврата.

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

GetVariable

Назначение

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

Параметры

  • [in] variableName – последовательность, содержащая имя переменной с терминирующим нулем.
  • [in] vendorGuid – структура, содержащая уникальный идентификатор поставщика, связанного с переменной.
  • [out] attributes – значение, биты которого интерпретируются как атрибуты переменной.
  • [out] dataSizeReal – размер данных, полученных через параметр data, в байтах.
  • [out] data – последовательность, содержащая значение переменной.
  • [out] rc – код возврата.

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

GetNextVariableName

Назначение

Перечисляет имена переменных EFI.

Параметры

  • [in] variableNamePrev – последовательность, содержащая имя переменной с терминирующим нулем, полученное при предыдущем вызове метода GetNextVariableName, или нули, если метод GetNextVariableName вызывается первый раз.
  • [in] vendorGuidPrev – структура, содержащая уникальный идентификатор поставщика, связанного с переменной, имя которой получено при предыдущем вызове метода GetNextVariableName, или нули, если метод GetNextVariableName вызывается первый раз.
  • [out] variableNameSizeReal – размер данных, полученных через параметр variableNameNext, в байтах.
  • [out] variableNameNext – последовательность, содержащая имя переменной с терминирующим нулем.
  • [out] vendorGuidNext – структура, содержащая уникальный идентификатор поставщика, связанного с переменной.
  • [out] rc – код возврата.

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

SetVariable

Назначение

Устанавливает значение переменной EFI.

Параметры

  • [in] variableName – последовательность, содержащая имя переменной с терминирующим нулем.
  • [in] vendorGuid – структура, содержащая уникальный идентификатор поставщика, связанного с переменной.
  • [in] attributes – значение, биты которого интерпретируются как атрибуты переменной.
  • [in] data – последовательность, содержащая значение переменной.
  • [out] rc – код возврата.

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

QueryVariableInfo

Назначение

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

Параметры

  • [in] attributes – значение, биты которого интерпретируются как типы тех переменных, о которых нужно получить сведения.
  • [out] maximumVariableStorageSize – размер памяти, которая предназначена для хранения переменных заданных типов, в байтах.
  • [out] remainingVariableStorageSize – размер неиспользованной части памяти, которая предназначена для хранения переменных заданных типов, в байтах.
  • [out] maximumVariableSize – максимальный из размеров переменных заданных типов, в байтах.
  • [out] rc – код возврата.

Нет.

ResetSystem

Назначение

Перезагружает аппаратную платформу.

Параметры

  • [in] resetType – значение, задающее тип перезагрузки (например, "холодная" или "горячая" перезагрузка).
  • [in] resetStatus – код, отражающий статус перезагрузки (например, штатная перезагрузка или перезагрузка из-за сбоя).
  • [in] resetData – последовательность, содержащая сведения о причинах перезагрузки.
  • [out] rc – код возврата.

Позволяет перезагрузить аппаратную платформу.