Contents

IORegistryCreateIterator(_:_:_:_:)

Create an iterator rooted at the registry root.

Declaration

func IORegistryCreateIterator(_ mainPort: mach_port_t, _ plane: UnsafePointer<CChar>!, _ options: IOOptionBits, _ iterator: UnsafeMutablePointer<io_iterator_t>!) -> kern_return_t

Parameters

  • masterPort:

    The primary port obtained from 1514652 Iomasterport. Pass Kiomasterportdefault to look up the default primary port.

  • plane:

    The name of an existing registry plane. Plane names are defined in IOKitKeys.h, eg. kIOServicePlane.

  • options:

    kIORegistryIterateRecursively may be set to recurse automatically into each entry as it is returned from IOIteratorNext calls on the registry iterator.

  • iterator:

    A created iterator handle, to be released by the caller when it has finished with it.

Return Value

A kern_return_t error code.

Discussion

This method creates an IORegistryIterator in the kernel 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 with calls to IORegistryIteratorEnterEntry. The iterator object keeps track of entries that have been recursed into previously to avoid loops.

See Also

Miscellaneous