iterateOver(const IORegistryPlane *, IOOptionBits)
Create an iterator rooted at the registry root.
Declaration
static IORegistryIterator * iterateOver(
const IORegistryPlane *plane,
IOOptionBits options = 0 );Parameters
- plane:
A plane object must be specified.
- options:
kIORegistryIterateRecursively may be set to recurse automatically into each entry as it is returned. This option affects the behaviour of the getNextObject method, which is defined in the OSIterator superclass. Other methods will override this behaviour. kIORegistryIterateParents may be set to iterate the parents of each entry, by default the children are iterated.
Return Value
A created IORegistryIterator instance, to be released by the caller when it has finished with it.
Overview
This method creates an IORegistryIterator that is set up with options to iterate children of the registry root entry, and to recurse automatically into entries as they are returned, or only when instructed. The iterator object keeps track of entries that have been recursed into previously to avoid loops.