CONFIGMG_Invert_Range_List

CONFIGRET CONFIGMG_Invert_Range_List(RANGE_LIST rlhOld, RANGE_LIST rlhNew, ULONG ulFlags, ULONG ulFlags)
 

Creates a range list that is the inverse of a specified range list; all claimed memory ranges in the new list are specified as free in the old list, and vice-versa.

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

rlhOld

Handle of the range list to be inverted.

rlhNew

Handle of a valid range list that receives the inverted copy of rlhOld. Anything contained in the rlhNew range list is removed by the operation.

ulFlags

Uppermost value of the inverted range list.

ulFlags

Must be zero.

For example, the inversion of {[2, 4], [6, 8]} when the ulMaxValue parameter is 15 is {[0, 1], [5, 5], [9, 15}.

If this function returns CR_OUT_OF_MEMORY, rlhNew is the handle of a valid but empty range list.