Edit

EngSort function (winddi.h)

  • Article

The EngSort function performs a quick-sort on the specified list.

Syntax

ENGAPI VOID EngSort(
  [in, out] PBYTE    pjBuf,
  [in]      ULONG    c,
  [in]      ULONG    cjElem,
  [in]      SORTCOMP pfnComp
);

Parameters

[in, out] pjBuf

Pointer to the data array to be sorted.

[in] c

Specifies the size, in bytes, of each element in pjBuf.

[in] cjElem

Specifies the number of elements in pjBuf to be sorted.

[in] pfnComp

Pointer to a function that implements the element comparison to be used for the sort.

Return value

None

Remarks

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 prototyped as follows:

int (__cdecl *SORTCOMP)(const void *pv1, const void *pv2);

where pv1 and pv2 point to the two elements to be compared. The return value is the result of the comparison defined as follows:

Return Value Meaning
Negative integer *pv1 < *pv2
Zero *pv1 == *pv2
Positive integer *pv1 > *pv2
 

The array is sorted in increasing order, which is defined by the pfnComp parameter.

Requirements

Requirement Value
Minimum supported client Available in Windows 2000 and later versions of the Windows operating systems.
Target Platform Universal
Header winddi.h (include Winddi.h)
Library Win32k.lib
DLL Win32k.sys