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 системной библиотеки