Create an iterator rooted at a given registry entry.
- macOS 10.0+
- Mac Catalyst 13.0+
The root entry to begin the iteration at.
The name of an existing registry plane. Plane names are defined in IOKitKeys.h, eg. kIOServicePlane.
kIORegistryIterateRecursively may be set to recurse automatically into each entry as it is returned from IOIteratorNext calls on the registry iterator. kIORegistryIterateParents may be set to iterate the parents of each entry, by default the children are iterated.
A created iterator handle, to be released by the caller when it has finished with it.
A kern_return_t error code.
This method creates an IORegistryIterator in the kernel that is set up with options to iterate children or parents of a root entry, and to recurse automatically into entries as they are returned, or only when instructed with calls to IORegistryIteratorEnterEntry. The iterator object keeps track of entries that have been recursed into previously to avoid loops.