WNDOBJ_cEnumStart función (winddi.h)

Artículo
08/27/2023

La función WNDOBJ_cEnumStart es una función de devolución de llamada que establece parámetros para la enumeración de rectángulos en la región visible de una ventana.

Sintaxis

ENGAPI ULONG WNDOBJ_cEnumStart(
  WNDOBJ *pwo,
  ULONG  iType,
  ULONG  iDirection,
  ULONG  cLimit
);

Parámetros

pwo

Puntero a una estructura WNDOBJ creada por una llamada a EngCreateWnd.

iType

Especifica el tipo de estructuras que va a devolver WNDOBJ_bEnum. Este parámetro puede ser CT_RECTANGLES, lo que significa que la región se va a enumerar como una lista de rectángulos.

iDirection

Determina el orden en que se devuelven los rectángulos. Este orden puede ser esencial cuando se realiza una drvBitBlt superpuesta en la misma superficie. Si el pedido no es relevante para el controlador de dispositivo, se debe especificar CD_ANY. Esto permite que GDI optimice su enumeración para regiones complejas. Este parámetro puede ser uno de los valores siguientes:

Valor	Significado
CD_ANY	Cualquier orden conveniente para GDI.
CD_LEFTDOWN	De derecha a izquierda, de arriba abajo.
CD_LEFTUP	De derecha a izquierda, de abajo a arriba.
CD_LEFTWARDS	De izquierda a derecha, no se define la dirección vertical.
CD_RIGHTDOWN	De izquierda a derecha, de arriba abajo.
CD_RIGHTUP	De izquierda a derecha, de abajo a arriba.
CD_UPWARDS	De abajo a arriba, no se define la dirección horizontal.

cLimit

Es una indicación del número de objetos que el controlador está interesado en el almacenamiento en caché. Esto solo se usa para decidir cuándo detener el recuento de rectángulos mientras GDI calcula el valor devuelto de esta función. Si cLimit es cero, no se realiza el recuento.

Valor devuelto

El valor devuelto es un recuento del número de objetos que se enumerarían, siempre que este valor sea menor o igual que cLimit. Si el recuento es mayor que cLimit, el valor devuelto es 0xFFFFFFFF.

Comentarios

La enumeración se puede reiniciar llamando de nuevo a esta función.

solo se debe llamar a WNDOBJ_cEnumStart:

En el contexto de la función de devolución de llamada del controlador proporcionada a GDI en la función EngCreateWnd , o las funciones DDI de gráficos donde se proporciona un WNDOBJ.
Cuando el subproceso que realiza la llamada tiene el bloqueo del dispositivo para asegurarse de que no se producen cambios en la región de cliente.

Requisitos

Requisito	Value
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