VOID EngSort(
| PBYTE pjBuf, | |
| ULONG c, | |
| ULONG cjElem, | |
| SORTCOMP pfnComp | |
| ); |
EngSort performs a quick-sort on the specified list.
Parameters
pjBuf
Pointer to the data array to be sorted.
c
Size, in bytes, of each element in pjBuf.
cjElem
Number of elements in pjBuf to be sorted.
pfnComp
Pointer to a function that implements the element comparison to be used for the sort.
Comments
EngSort implements a quick-sort algorithm to sort cjElem elements in pjBuf, where each element is of size c. The sorted elements are returned in pjBuf; that is, the original contents of the buffer are overwritten with the sorted results.
The basis for comparing two elements is defined in the function that pfnComp points to. This function is defined as follows:
INT Compare((VOID *)element1, (VOID *)element2);
where element1 and element2 are the two elements to be compared, and the return value is the result of the comparison defined as follows:
| Return Value | Meaning |
| Negative integer | element1 < element2 |
| Zero | element1 = element2 |
| Positive integer | element1 > element2 |
The array is sorted in increasing order, which is defined by the pfnComp parameter.