hwi_find_item()

Найти элемент в структуре hwinfo

Прототип:

#include <hw/sysinfo.h>
unsigned hwi_find_item( unsigned start,
... );

Аргументы:

start
Стартовая позиция поиска заданного элемента. Для первичного вызова необходимо установить значение аргумента HWI_NULL_OFF. Если найденный элемент не соответствует ожидаемому, необходимо передать возвращаемое значение из первого вызова в качестве параметра start следующего вызова hwi_find_item(). Это позволит возобновить поиск с того места, где он был прекращен в прошлый раз. Процедура может быть воспроизведена столько раз, сколько это требуется (возвращаемое значение второго вызова устанавливается аргументу start для третьего вызова и т.д.).
char*
Последовательность наименований для идентификации искомого элемента. Последовательность завершается NULL указателем. Последняя строка перед NULL - это искомый элемент нижнего уровня, строка перед ним - это имя элемента, которому принадлежит элемент нижнего уровня и т.д..

Библиотека:

libc

Описание:

Функция hwi_find_item() находит элемент в структуре системной страницы hwinfo.

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

Отступ до искомого элемента или HWI_NULL_OFF, если элемент не был найден.

Примеры:

Находит первое вхождение элемента с именем “foobar”:

item_off = hwi_find_item( HWI_NULL_OFF, "foobar", NULL );

Находит первое вхождение элемента с именем “foobar”, который принадлежит элементу с именем “sam”:

item_off = hwi_find_item( HWI_NULL_OFF, "sam", "foobar", NULL );

Классификация:

ЗОСРВ «Нейтрино»

Точка остановки потока
Нет
Обработчик прерываний
Да
Обработчик сигналов
Да
В потоке
Да

Тематические ссылки:

hwi_find_tag(), hwi_off2tag(), hwi_tag2off()




Предыдущий раздел: Описание API системной библиотеки