hwi_find_tag()
QNX SDP8.0C Library ReferenceAPIDeveloper
Find a tag in the hwinfo structure
Synopsis:
#include <hw/sysinfo.h>
unsigned hwi_find_tag( unsigned start,
int curr_item,
const char * tagname );
Arguments:
- start
- Where to start to search for the given item.
For the initial call, set this argument to HWI_NULL_OFF. If the item found isn't the one that you want, pass the return value from the first call to hwi_find_tag() as the start parameter of the next call. This makes the search pick up where it left off. You can repeat this process as many times as required (the return value from the second call going into the start parameter of the third, etc).
- curr_item
- If this argument is nonzero, the search stops at the end of the current item (i.e., the one that start points to). If curr_item is zero, the search continues until the end of the section.
- tagname
- The name of tag to search for.
Library:
libc
Use the -l c option to qcc to link against this library. This library is usually included automatically.
Description:
The hwi_find_tag() function finds the tag named tagname.
Returns:
The offset of the tag, or HWI_NULL_OFF if the tag wasn't found.
Classification:
| Safety: | |
|---|---|
| Cancellation point | No |
| Signal handler | Yes |
| Thread | Yes |
Page updated: