Función EngSort (winddi.h)

La función EngSort realiza una ordenación rápida en la lista especificada.

Sintaxis

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

Parámetros

[in, out] pjBuf

Puntero a la matriz de datos que se va a ordenar.

[in] c

Especifica el tamaño, en bytes, de cada elemento de pjBuf.

[in] cjElem

Especifica el número de elementos de pjBuf que se van a ordenar.

[in] pfnComp

Puntero a una función que implementa la comparación de elementos que se va a usar para la ordenación.

Valor devuelto

None

Observaciones

EngSort implementa un algoritmo de ordenación rápida para ordenar los elementos cjElem en pjBuf, donde cada elemento es de tamaño c. Los elementos ordenados se devuelven en pjBuf; es decir, el contenido original del búfer se sobrescribe con los resultados ordenados.

La base para comparar dos elementos se define en la función a la que apunta pfnComp . Esta función se crea un prototipo de la siguiente manera:

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

donde pv1 y pv2 apuntan a los dos elementos que se van a comparar. El valor devuelto es el resultado de la comparación definida de la siguiente manera:

Valor devuelto	Significado
Entero negativo	*pv1<*pv2
Cero	*pv1 == *pv2
Un número entero positivo	*pv1>*pv2

 

La matriz se ordena en orden creciente, que se define mediante el parámetro pfnComp .

Requisitos

Cliente mínimo compatible	Disponible en Windows 2000 y versiones posteriores de los sistemas operativos Windows.
Plataforma de destino	Universal
Encabezado	winddi.h (incluya Winddi.h)
Library	Win32k.lib
Archivo DLL	Win32k.sys