CONFIGMG_Sort_NodeList

CONFIGRET CONFIGMG_Sort_NodeList(NODELIST_HEADER nlhNodeListHeader, ULONG ulFlags)
 

Sorts a list of nodes that has been passed to the handler of to a resource arbitrator.

• Returns CR_SUCCESS if the function is successful. Otherwise, the return value can be CR_INVALID_API, CR_INVALID_FLAG or CR_INVALID_NODELIST.

nlhNodeListHeader

Address of a NODELISTHEADER_S structure containing the elements to sort.

ulFlags

Must be zero.

This function is normally used by an arbitrator to sort the nodelist it is given during a call to the arbitrator's handler. Normally, an arbitrator sorts the nodelist by increasing ease of configuration; for example, an element that had only one possible IRQ would come before an element with 2 possible IRQs, and so on. The arbitrator must first do a linear scan of the nodelist initializing nl_ulSortDWord (the lower the value, the more at the begining the element will be).